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Susbsription service now available, running on 
Mac OS X Server. 

Details at: www.netteamserver.com/subscribe 


K Connect your people, contacts, relationships, projects, tasks, documents, 
btogsf web contentyour knowledge itself ... and magic follows. 


Most businesses already have this data but in different systems, used by different people, in different 
departments. What a nuisance! NetTeam Server brings it all together, in a web app that everyone can 
use, anywhere. What a difference! 


NetTeam Server 


Features 


NetTeam Server is a business process, content management, collaboration 
and social networking web app for businesses and organizations of any 
size. It offers people, project, task and document management services 
and has a powerful API to support customization. 

The triangle represents NetTeam Server's unique combination of 
functionality for three critical areas: Process, Content and Community. 


NetTeam Server's fundamental constructs are 
Peqsle, Projects, Tasks and Documents. 

These four are central to all business activities, so vre 
bring them together in a coherent workspace that 
makes NetTeam Server a true Sosiness Operoting 
System. The portal interface can be tailored to match 
client branding and linked systems, and includes five 
Editors (see screenshot) and a modem, AJAX-enhanced, 
configurable user interface. 
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User roles determine access priviteges and which (if any) 
tooCs are presented on login. 8togs are used extensively 
to supiDort publishing, informacion and knowledge 
management. Wikis will be available in a Late- 
summer update. 


NetTeam Server is available for N^c OS X Server, Linux and 
Windows platforms and supports all leading web browsers. 
A Web Services API allows tight integration with otfier 
systems and single sign-on. We also offer a Java mobile 
client which can be tailored to support rrtobile workforce 
applications. 

NetTeam Server has been successful in deployments 
serving frcNm 10 to 10,000 users and may be installed on a 
server of your choosing, used on a dedicated server we 
provide, or rented as a subscription service (myitis 
company server). 


Consultant, reseller and developer enquiries welcome. 


WeYe a good choice even if you only need one of these, but if your 
business operations embrace two or three, youHl love what we can 
do for you. 


- Project Workspace 

- Team/Tasks 

- Workflow 

- Documents 


Web Content/Site Management 
Web Document Library 
Project and Shared Blogs 
News Editor 


* Users, roles and relationships 

- Simple CRM 

- Social Networking 

- Profile & Personal Blogs 

















if Cyour_website_stats == ???) { 
try_visistat = free; 
setup = no_brainer; 
web_stats = !!!; 


} 


else { 

no_clue = true; 

} 

//REAL-TIME WEBSITE TRACKING 
goto = www.visistat.com; 
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WWDC: It's like going to a rock concenl Lights, 
riiusic, :ind audio and video gear lliat the likes of U2 
tour with! Of course, Ix^neath the ^sliow*, riiere are 
important announcemenis: die kind that impact the 
way we work as Mac'reclis. No matter if you’re a 
developer, IT staff tech, or an end user, tlie 
announcements of today will have an effect on you. 

You may have been at WWDC, or, you may have 
watched the keynote on-line. YouVe surely read 
about the announcements in blogs and on Apple's 
site itself. Tlie (announced) changes in Leopard are 
incredibly welcome, and the announcements to come 
will .surety be incredible. No matter what ihcy are, 
they're going to lie covered here in MacTech. lliis is 
being written on the first day of WWDC right after the 
keynote where attendees were given lO.S [ireview 
installers. The exdlement can be felt even on this 
first day, but it is tempered with a lecli attitude: let me 
understand how it w'orks, and then 1 can implement 
and rely on it. bach of these announcements mean 
different things to different people. After talking to a 
lot of people, though, one feature scetns to stajid out 
over the others: Time Machine. 

Time Machine is an automatic, hands-off backup to 
disk or server. The real killer is the LI I - something that 
anytaie will just 'get' immediately, almost more so than 
anything Apple has ever pul out. Backup happens at 
midnight l>y default (we don^t know il* this is easily 
adju.slable) and backs up every^thing. As of this writing, 
no storage ruie-of-thumli guidelines iiave been posted. 
There's a fantastic developer opportunity here to make 
sure your app is Time Machine enabled. Really, you 
don't wiint to miss lliis one. The Time Machine page is 
http://w^ww.apple.com/macosx/ieopard/iimema chine, h 
mil, and it's well wortli a visit. 

XCode 3. along with Dashcode and Web Clip 
were also announced. XCode 3 brings us some great 
new deiiygging tools along with., well, things that 
we’re still under NDA and can't talk about! 
i!)ashcode and Web Clip are welcome additions to 
tlie developer's arsenal. Web developers everywhere 
rejoiced with tlie addition of a JavaScript debugger! 
Web Clip is more of an end user-lechnology, and 
some people that I spoke with arc a little hesitant. 


J'he fear is that the support calfs may start to come 
in, only for a tech to find that a user has created 
dozens of Web Clips and hinders Dashboard and 
machine perfornuince. 

Of course, then there were the hardware 
announcements. The Mac Pro was tlie 'expected' 
announcenienl. Turns out to be one sweet macliine. 
Hie 2 dual-core Xeons are almost not noticeable: no 
liquid cooling, no gigantic fans. Instead of reducing 
the case size, though, Apple took the newly freed up 
s|iace and just packed more in. With 4 drive l^ys, 3 
full-length IXd-e slots, 2 optical drives and one 
double-wide 16-lane PCI Hxpress graphics slot, this 
machine earns the “Pro" moniker. 

To be able to claim that the entire product line has 
been Intelified, Appli* dropped the Intel XServe bomb. 
Redundant power supplies! Two dual-core Xeon chips 
suppoiting u[i to 32GB of memory! “Lights out 
management/ however, wasn't given a detailed look. 
WJiile it's an improvement (over, basically, nolhing), it 
looks like it's simple [lower on/power off Let's just say 
there might be some syr|inses in store. Much like the 
Mac Pro, Apple cliose to keep tlie satnc fonii factor and 
use the space more wisely. The Intel-based XServes 
sport buUNri VGA. No more sacrificing your 
configunttion to either add a video card, or figure out 
how to wf>rk around not having one. With 2 built-in 
Ethernet porT.s, you can throw in a two or 4 port 
Ethernet card and have one heck of a 
router/fi re wall/VPN device. 

Nam rally, with an Intel based XServ'e, that means 
we need an Intellified OS X Server. OS X Server 10.4.7 
will lx- the first Universal dLsc shipped - meaning, a 
single tiisc will IxKJt either a PPC or Intel machine. 

Team Apple have been exceedingly busy. 
Everyone deserves a big round of applause (^and 
probably a raise or two!) for their work. New 
hardware, new software. Everyone at MacTech is 
looking foi%vard to seeing how you make use of all 
this new Lech, and, we're looking Fomard to guiding 
you through it. 
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Mac In Tut Shell 


by Edward Marczak 

Back to 
the Shell 

Revisiting the basics in an 
advanced kind of way. 

V___ J 

Introduction 

Recently, I’ve gotten a iitinil>er of people contacting me 
asking if 1 could write .some more about the shell''. Well, 

for close to two years, that’s just alxjui all this column talks 
al)oui! But, that means it’s time for me to get back to baslc.s. For 
the long-time reader, tlxnigh, I’ll get into some command-line 
goodness that I haven^t tread upt>n quite yet. 

The Shell 

When you run l erminakapp, that's your gateway to a sbeit 
the iexi-lra.setJ command inierpreier. This is similar to a DOS 
shell or MSH under Windows, an xterm in X, or, a dedicated 
hardware femiirial lliat is aerially patched inU> a host. This is the 
(jriginai CRT interface into a .system (props to punch cards and 
paper-based teletypes). 

Some people also call a GUI interface a “sheir. While tluit's 
proi)al>ly partially correct, for the purposes of this column, 
“shell” will always refer to the Lext-ba.sed, command-line driven 
variety. Nor will it refer to file manipulation shells like Midnight 
Commander, et al. 

Different sliells have arisen over the years, with the Bourne 
Shell, or ‘’sh” being the original Unix shell. The C-Shell, or 
became a popular alternative. Finally, “bash", or, the “Bourne 
Again ShelP added many features to the original sh, and is now 
the default shell in OS X (starling with 10.3 - 10.2 and earlier 
used c'sh as the default). When I say “defaulf, I mean just that: 
it’s a nice ge.siure that the OS chooses something for you, but 
you can choasc any .shell you like as your default. A useTs shell 
is stored in their user record, eitlier in Nednfo or OpenDiretaory. 

Tliat's the abridged {re)introduction: A shell is a user 
interface tiiat accepLs input, proc'esses that input, and produces 


output. For a much deeper introduction, please refer to my 
March 2005 column in MacTech. (Available now^ by the way as 
part of the MacTech CD - < http://www.mactgchxom/cd >). 

Father’s Day 

Father’s Day, 2006: Not only am / a father, but 1 happened to 
\nj at my Father's house. Of anirse. I’m also a consultant, and 
holiday.s don’t stop clients from calling when ihere is a pii)blem! 
So, when I got a “but I'm sure it will only you a minute” call 
during the day, 1 figured Vd make a client happy. But I didn’t have 
my laptop, or any OS X Ikjx for that rmiiier, i liave to admit that 
my Father is a Windows guy, so ! had access to liis machine, 
lltere are plenty of ssh clients for Windows (with PuTTY teing my 
hivorite < hnp7AAAAW.chj3rk.Qreenend,Qrg.uk/-sgtatham/putW^ and OS 
X Sender has ssh enal>led l>y default. Ft^d fmc to enal)le it in OS 
X by opening the Sharing Pmf Pane and placing a check niitric next 
to “Remote Logur. ssh, if yixi are unfamiliar witfi it, is the Seaire 
Shell. Now, it's not really a shell in and of iLself, Init a way tt> 
access a remote shell - typially one on another machine. It's 
'secua*^ lx?cause all lolTic lx.iween the ssh t*lient and die ssh server 
is encrypted. Tlie inonil t>f tills talc turns out to he ilic Why’ 
setiion of ibis article. “Why should 1 ua" a text-based interfaa* 
wlien I have yummy At|ua?" kn me (lirietly) count the ways: 

1. Power: Quickly find and affect a huge nuntlier of surgically 
selected files. 

2. Power: Many limes, in many w'ays, it’s the GUI that’s still 
catching up with tlie shell. Tfiere are options in many of the 
shell totals that just can't Ik‘ ix'iformecJ with the GUI. 

3. Power: think abfjul the reach that a tool like ssh gives you to 

access, install, troublcshcKrt and diagnose remote machmes. 
(1 never had to leave my Fatlier’s house that day). 

Shell Lite 

As it turns out, it only dkl lake me a minute with that 
problem: Windows services just got a little funky on an OS X 
Server machine, smbd was running, liut nmbd had died off. 
This meant OS X macl lines t'ould, in tests, access the server 
using smb://ip.ad.dr.ess, but genuine Windows machines 
(XHiklnf browse for shares. So, I stopped smb, and started it up 
again - problem solved. Mow'd 1 do that without the GUl-liased 
Server Admin? Easy: the shell-based serveradmin. 

I detest opening a console on an OS X Server if it c^n lx: 
avoided. 999^} of the time it can lie (or dose to it. Did you know* 
that 47% of all suilislics are made up?). Yes, there are 
applicatioas tiiat require a GUT session to remain logged in. 
Thankfully, those are a dying breed. So rather than fire up a 
resource-heavy GUI, I -ssh in and use serveradmin: 
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184 hours finding that one bug 
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11 all-nighters ^ 

1 call protects it all! 
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The new HASP family of products is the 
next generation in protection ensuring the 
highest level of security for your software, 
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cally protect your software and implement 
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Mest overall solution as rated by 
an independent testing lab: 
tn Key Labs tests, HASP HL outperformed 
the competition in security, ease-of-use, 
flexibility of tools and funaionality, 
and compatibility across platforms 
and environments. A copy of the full 
KeyLabs report is available from our 
Web site at www.Aladdfr^.com/MacTecti. 


^ Robust envelope: 

Automatically protects Windows 
executables, DLLs, .Net and 
Mac applications, securing the 
weakest link and ensuring your 
valuable IP remains unreachable 
Multiple protection layers 
provide unequaled security. 
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and funcijonality 

10% 
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71.2% 

Compatibility across 
platforms and 
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93.3% 

71% 
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# serveradrain stop smb 

# servGradndn start smb 


As youVe probably guessed, tiie first line has server admin stop 
Windows services (smb stands for Server Message Block, which 
is the protocol ihai Windows uses, and from where SaMBa 
derives its name). Also note that this is only available on OS X 
Server. Let's take a closer look: 

# serveradmin list 
afp 

appserver 

dhep 

dlrserv 

dns 

fllebrywser 

ftp 

info 

ipfilter 
jabber 
mail 
nat 

netboot 

network 

nfs 

print 

privs 

qtss 

qtsncontents 

signaler 

sihb 

swupdatK 

vpn 

web 

webobjects 

xgrid 

xaerve 


This displays a list of all services that serveradmin knows how 
to control. This provides a way to stop, start and gel status on 
each service. Better yet, you can read all of llie settings for any 
particular service. Let's capture our settings for OpenDirectory: 
(See Listing 1.) 

We can save all of those settings in a file by redirecting the oiitpuf: 

If sGtveradffiln settings dirserv > od_settings.txt 

We can restore those settings by redirecting that saved file back 
into serveradmin: 

# serveradmin settings < gd^settiiigE.tart 

Nicely, you can gather all settings: 

# serveradmin settings all > all_settings*tKi: 

Of course, you can set most of those values, too: 

f serveradmin settings afp:guestAccess = yes 

The Locked Finder 

Ever have the Finder lock up on you? You may still see 
certain apps running, but you just can't interact with anytliing. 
Well, the Finder is just another prt^gram running on your system 
{and one that's severely deprecated since the OS 6/7/8/9 days). 
If you want to shut down cleanly, you can ssli into the machine 
in question and issue a shutdown: 


if serveradmin settings dirserv 
dirserv:3ecureConfigRecord:errorValue - 2 

dirserv:secureGonfigRecord:statusMeEsage “ "Unable to find a computer record for this computer" 
dirserv :tanKerberize * tio 

dirserv:LDAPSettings:LDAPDatalasePath = "/vat/db/openldap/openldap-data 

dirserv:LDAPSettlngs;searebTimeout = 3600 

dirserv:LDAPSettltigsjLQAPSearchBase " "dc"radiotope,dc"coiii" 

dlrserv:LDAPSettlng^:LDAPSSLGectificatePath ^ 

dirserv:LDAPSettings:LDAPCACertificatePath = “” 

dirserv :LDAPSettiiigs;LJ}APServerBackeud “ ’’bdb" 

dirserv:LDAPSettingsMJseSSL = no 

dirserv :LDAPSettings:!naxSearchReEuits ^ " 11000” 

dirserv:LDAPSettings:LDAPTi]iie£)UtUnitfi ^ "‘seconds'' 

dirserv: LDAP Set tinge I LDAPSSLKey Pa til = 

dirserv:masterConfig:replicas:„array_index:0:replicaAddress ” "192,168.30,8” 
dirserv:masterConfigireplicasi_array_index;0:replicaStatus * "OK” 


dirserv: re plicaLastUpdate = 
dirserv:masterServer = 
dirserv:LDAPServerType ” "maEter” 

dirserviKacOSXODPollcy:Configured Security Level:Binding Required = no 
direerviftacOSXODPolicy:Configured Security Level:Packet Encryption = no 
dlrserv:MacOSXODPolicy:Configured Security Level:Man In The Middle “ no 
dirserv:Mac0SX0DPollcy:Configured Security Level:No ClearText AuthentlcatloriiS - yea 
dirserviMacOSXODPolicy:Directory Binding = yes 


dirserv: kerberlzedRealiiiLlst i availableRealms: _array_lnd ex: 0: dl rModePath = " /LDAPv3/127,0,0,1" 
dirserv:LDAPDefauitPrefix " "dc"lycaeuri,dc^radiotope,dc"Com” 


dirserv:PWPolicyInfo:passwordNotAccount = 1 
dirserviPWPolicyInfo:passwordDisableDate ^ 0.000000 
dirserv:PWPolicyInfo:passwordDisableFaiIedLogins = 0 


Listing 1. 
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Now Mac friendly 


You can now p/ay at PartyPoker.com on your Mac. 

To get you started, p/ease use t/ie sign-up code 
MACT and you'll receive a bonus of up to $100. 

For t8 yesrs- i (or 21 wherr? renulretll Terms iind coriditbns Jifpply, see www.jjdrtvpokef,<oiTi/lt?^,il Void prohibited. PE»nyP 9 ker is a trade ond seryke murk of PaftyGaming Pfc, a 100, publicly 
tEsteiJ company on the London Stack Ejichange. AH rlgirtt reserved 2006, For custamor en^wlrles please call h800'!?52 4719 (tolFfreo USA and Ciinsda), Apple' and Miic‘ ara rrademarks cmd/or lerwcw 
marks Apple Compulers Ini and m llcuncr, a(TiTlfltmni,ai?or>5QfafTlp or endoFscmenT Is dalmed fronr thK uvii of these tf adetimiM here. FdriyGdmbg U not alfillttied^ iicenscd by, dr othervrbcfiliated ssHth 
Apple Co mpulefslrtc Irr any way. 02^7 


PartYPmeRf 

The World^s Largest Poker Room * 


ff shutdown -h now 

The ‘"-li” switdi stands for iialt” (power down). You can also 
reboot the maciiine with the “-r” switch: 

# shutdown -r now 

Depending on the state of the maciiine, ^shutdown' may even 
hang. Bin rebof)t gcx^s to tlie heari of ilie matter a litile more 
quickly. Just issue: 

reboot 

The box should come down in a liun^ and relxjot. Sometimes, 
of course, you just have to accept defeat and understand that a 
hung Ixjx just isn't coming back. 

Invisible 

Without third-party add-ims, the Finder isn’t able to mark 
a file visible or invisible (or, iiidden"). With Apple’s 
Developer Tools installed, you have access to some utilities 
tiial can manipulate Finder-level meladala. Inside 
/Devloper/Tools, you’ll fmd SetFile and GetFileInfo 
nestled among many other programs. Use GetFileInfo to 
peek at a file's current settings: 

$ ./GetFileInfo /tlsers/m^rcsiiik/Plctures/lGbat \ 

Icoiiii/Flags/UK. uif 

file: /Libraty/Application Support/Apple/iChat 

Icons/Flags/UK,gif" 

type: 


creator: 

attributes: avbstcllnmedi: 
created: 03/21/2005 00:08:23 
modified: 03/21/2005 00:08:23 

(note how GetFileInfo property de-referenced the alias in 
use here). Tliis should all be pretty self-explaiuitoiy with the 
exception of the 'attributes' line. Each letter represents one 
atiribnie; if it's a lower-case letter, that aitrihiite is off, upper-case 
is on. The attributes are: 

A Alias file 
B Bundle 

C Custom icon (files and folders) 

D Desktop (hies and folders) 

E Hidden extension (files and folders) 

I Inited (files and folders) 

M Shared (am run multiple times) 

N No INIT resources 
L Locked 

S System (name locked) 

T Sta Li emery 

V Invisible (files and folders) 

Z Busy (files and folders) 

Now, you can use SetFile to change any of those attributes. To 
make a File hidden to the Finder: 

$ /Developet/Tocifi/SetFiie -a V 
/Users/erm/Applications/Secret.app 



Connect • Communicate • Collaborate ■ Securely 


Kerio MailServer 

A groupware alternative to 
Exchange that syncs calendars, 
contacts and email with Entourage 
and Outlook. Integrated anti-spam 
and McAfee virus filtering provide 
secure, junk-free email for users on 
any platform. 

Mac OS X - Linux - Windows 
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Mercury'"' Elite-AL Pro 

World's best aluminum enclosed 
storage solution, Single Drive models 
up to 75DGB, Duai-DfiveBAIDs up to 
tJTerabtye^ 500GB). 

V' Available SATA, RreWire800, 
FireWire 400, USB 2,0 
interl'ace options, 
High4>erformance ,' ■ 
& A A/Certified, 

VearW^rranty.:: 


NOW 

750GB 


SALE Pricing 
on all 500GB 
solutions 
..from $265r 


nmu Stack ^ 

USS/FireWire Port Expansion Hub 
NewerTech miniStack’^Vl adds both rear and 
side FireWire and USB Hub ports. Up to 750GBI 
Ideal for: HomeEhtertalnment, AudioA/ideo, 
Backup, Bootable Data Storage, Mos/c, Graphics 


Serial-ATA 
FireWire 800 
FireWire 400 
USB 


Take Advantage of Low Prices Now 
www.MacSaiesxom/firewire ' 


since '1988 


Checkout our full 
line of external 
storage solutions 
plus much more at 
ww'w, m ocsP/es.a?fi7 


Own the Future... > 

^ Bus-po wered portable stQwge 
*FireWire&USB ^ 

*Upto 1.5TB 
* Award Winning Quality 





















...and ro bring it back: 

$ /Developer/Tools/SetFile a v 
/Users/firm/Appiications/Sec ret.app 

Hic bdiavior for [tiding and unhiding lias cfiangcd somewhere 
along tlie line. While the change for both used to be immediate, 
only hiding is now. Once you use “-a v” - the ‘visible* switch, 
the Finder doesn’t pick up the change, and retjuires a relxxH (or, 
perhaps a log out and log in). 

Full Circle 

just to make this coinplete, 1 w'ant ro tbUow-up on the ‘shelF 
issue. As 1 mentioned, you’re free to seleti any sliell you like. By 
default, new accounts in Panther and Tiger (10.3 and 10.4) will 
setup bash as the default. However, if youVe upgraded from 10,2 
or earlier, your user record cume over iniac:l, and will ,stiH retain 
your setting for C-shell (csh). You can detennine which shell you 
use in a few ways, If you already have a shell open, type 'sef. 
This displays a list of environment variables. If you’re using basil, 
you’ll have some varialtles defined that start with ‘"BASIT. C-Shell 


defines a Version' variatile. Z-Sliell (zsh) defines some variables 
tliat sUirt widi Perhaps even more definitive would be to 

am a paK‘ess status and kx)k for your user name: (See Li,siing 2.) 


We can check our user record to see what our default is: 

$ dscl localhost read /NetInfo/root/Users/raarezak | grep -i 
nhell 

UserSlien: /bin/bash 


Flowever, just because we have a default shell doesn’t mean we 
can’t override it in some way. You can simply am another shell 
by typing its name; 

Jack-Kerouak:^ marczak$ set | grep BASH 
BASH“/bin/bash 

BASH_VERSINFO=(tOj='’2'‘ [l]="05b" t4j =^reiease" 

[5]=''powerpc‘apple-darwln8.0“} 

MSH_VERSI0N= * 2.05b, 0 (1) - release' 

Jack Ketouak:"^ marc?,ak$ csh 

[Jack-Kerouak;“J raarcKak% set | grep version 

version tesh b.12^00 (Astron) 2002’07 25 (powerpe apple darwin) 

optlQUfl Bb. nis .dl >al. kan. sm, rh, color. dspin, fllec 

[Jack-Kerouak:"'] itiarczak% ejtit 

exit 

Jack-Kerouak:'' marezak^ 


$ ps aux 
marezak 

1 grep 
496 

onarezak | 
0,7 0,0 

grep sh 

27fil2 

73& 

p? 

Ss 

Thu03FM 

0:01.82 

/btn/bash 

Matezak 

3432 

0,5 -0.0 

27312 

364 

p7 

RT 

6:40AM 

0:00.00 

grep sh 

tna rcaak 

323 

0,0 -0,0 

27812 

183 

pi 

S 

Thu03PM 

0:00.02 

■bash 

ma rezak 

486 

0,0 OM 

27812 

183 

p2 

Ss+ 

ThuOaPM 

0:00.01 

/blii/baah 

niarczak 

490 

0,0 '0,0 

27SX2 

648 

p4 

Ss+ 

lliuOlPM 

0:00,18 

/bin/bash 

marezak 

492 

0,0 '0*0 

2 7812 

664 

p5 

Set 

Thu03FM 

0:00.18 

/blii/bash 

TDarezak 

494 

0.0 '0.0 

27812 

612 

p6 

Ss+ 

Thu03PM 

0:00,15 

/bin/bash 


Listing 2. 
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Products and Custom Development Services 

www.automatedworkflows.com 


Automator Action Packs! 


• FileMaker Pro 
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* iPhoto 
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• TextEdit 


• InDesign 

• Photoshop 
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Translate Macintosh* MultiCore 
Power into Application Performance 

Get your applications ready for parallel and scalable processing 


Right the first time: 

Intel® C++ Compiler for Mac OS* is a highly optimized compiler 
designed to handle the most demanding applications. Intel augments 
these compilers with advanced support for threading through OpenMP* 
and auto-paraiieiism capabiiities. 

Intel* Fortran Compiler for Mac OS* provides a fast and easy way 
to get maximum appiication performance for compute intensive applications. 
This compiler supports OpenMP* and auto-parallelism to take advantage of 
performance features available in the Multi-Core Intel" Processors. 

Inter Math Kernel Library for Mac OS* is a set of highly optimized, 
thread-safe, mathematical functions that reduces the need for hand-coding 
and allows developers to achieve outstanding performance for engineering, 
scientific and financiai applications. 

Intel’ Integrated Performance Primitives for Mac OS* enable software 
developers to achieve maximum appiication performance and reduce 
development time. They provide highly optimized functions for math, graphics, 
multimedia, audio, video, speech, computer vision, image, cryptography and 
signai processing that have been heavily optimized for Inter processors. 


\ 

"WeVe been an Intel C++ compiler customer and are 
impressed with the results. We are encouraged by Intel's 
commitment to expand their software development tools 
to support the exciting new Intel-based Mac platform." 


Kevin Tureski—Director of Engineering. Maya, Alias Systems 
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If you're a csh user^ you may need Lc> run an inslaller 
that depends on l)ash. That’s easy to deal with without 
changing your login shell* Either type 'bash' to run a 
bash shell, and then exit it when you’re done, or, 
prepend tlte ca>nimand with i>ash\ 

The traditiona! way to change your default shell is 
to use 'chsh* (change shell.) while logged in at a shell* 
This continues to work in OS X. Running chsh will 
present ytJu with a vi editor (by default) that lets you 
update your sheiL Save the file, and at next login, 
you’ll see the new shell in acUon. chsh has been 
patched on OS X to reach into the appropriate place to 
update your shell in your user record. 

Of course, you’re free to update your user record 
directly using dscl or niutil. 

Finally, you can have lerminahapp nin any shell 
{or app) you’d like, despite your default shell settings* 
Figure 1 shows tlie Tenuinal.app preference that lets 
you choose a shell to runr (top of next coIuiTin) 

The ‘‘Execute this command" option can be chosen iiather 
than simply running the default shell from your user 
record. 1 use 'screen' as the shell on my personal setup. 
(See “Screen: Living in A Virtual World", MacTech, 
September 2(K)S, or, find it on the MacTech CD), 


When your customers 
need a helping hand, 
don't you want to be there? 



With Mac HelpMate Pro, 
you're just a click away. 
www.MacHelpMate.com/testdrive 

Mac HelpMate Professional features: 

* Zero-configuratioa screen sharing (no iP address, no router tweaking necessary). 

It worA:s through 90% offirewalhandNATs. Reach anyone in the world wherever 
they are, wherever you are ... 

* Your €ompony*$ image and logo on the splash screen of the application reinforces 
your brand, services and safes offerings as weli as generates new opportunities 

* Automated maintenance tasks create biiiabie subsenptiombased services 

* One uniimited license covers mtaiiation for all of your customers^workstations 
' Cross platform: Mac - Mac, Mac - Win, Win - Mac and Win - Win 

Mac HelpMate Professional ^ Is a product of MOST Training & Consulting 
WWW. ma cworks hops.co m 


0 O ^ Terminal Preferences 

When creating a new Terminal window; 

0 Execute the default login shell using /usr/bin/login 
O Execute this command (specify complete path): 

/bln/bash 

Declare terminal type (ITERMJ as: ^^100 1T| 

Q Open a saved .term file when Terminal starts: 

( ) 


Figure 1: Terminal.app Prefs 

Finish 

In short, there’s no magic* "Using the sheir is just a 
matter of prac:tice, even for those experienced and familiar 
with it. Sometimes, “using the sheH" involves knowledge 
of one particular tool, which may run dexfp. Reading 
about it only gets you so far, though. Open up 
TenninaLapp Cor iTerm, or ssh in from a Linux or 
Windows box) and start typing! You won’t break 
anything* If you're really parancsid, clone your settip or 
run on a test system. In any case, getting in an really 
doing it is what it’s all about. 

Media of the monih! 1 ihink this is die first time 
Lhai Tm gt)ing to recommend a Mac-centric title! Amit 
Singh has released his long awaited “Mac OS X 
internals — A Systems Approach". Now, this is not light 
reading in any sense of die word* The book is 1,600+ 
pages (physically heavy), and tends toward the deeper, 
more techy, only-5-people-at-Apple-knt>w-Lhis kind of 
male rial* However, yt>u will gain OS X knowledge 
from tliis book, even if you do not understand it all! 
Refer to Amit’s profile in Iasi monih’s MacTech 25 for 
a tittle more understanding about his works. In any 
case, it's highly recommended! Check it out at 
< httD://www*osxbook.com >. 

Next month, more sliell nuggets. Until then, keep 
practicing! 

Yill 


About The Author 

EdMofaiA often finds Imseffimng m a sAa/^m 
fAffdt « mmther part of the vmU, bdmd Hie 
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From Macs to mobiles, devices to Nintendo DS™ 
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The Style Council 




Externals and Internals of Styles on Microsoft Word 2004 for Mac 




By Rob Dayl & Rick Schaut 


Word Styles are almost as old as Microsoft Word itself. la 
ha, Word Styles will celebrate tlieir 20*^^^ anniversary next year, 
lx.‘ing the double helix of Word's 2 million + linens of ccxle since 
Word ^.0 for PC released in 19H7. This article expenses and 
celebrates both the fundamental atscading tehavior of styles as 
they appear to the user anti the back-tmd implementatkjn of 
what is a very elegant piece of code infusion. For brevity^ f>nly 
some of tlie fundamental principles are discussed here. 


Wliat is a Word Style? 

_Q_ Formattinfl PaJenc _ 


> Fom ■ 


VStyteft 


Currertt style of selected text' 


Normal 


Hew 5iyle„. 




Se\ect All 


Pick styl* to apply- 

Cli:^ Friniqiitdiig 


Heading 1 

1 


Heading 2 

S 

i 

Heading 3 

1 


NormoJ 

% 



List Available styles 

> Alignment __ 

BuUcts and Wumbertng 
V Borders and Shading_ 

► Document 


Figure 1. Word Style Gallery 


In simple terms, a 
Word Style is a collection of 
pre-detined or user 
cusiomi/able foniiaiting 
pro]>erties. By default, 
when Word la u nches, 
around J50 Word Styles (of 
varying types) are av^tilaljle 
for useis to choose from. 
This is a vast list that has 
Ix^en developed over llie 
years tt) facilitate common 
ftjrmalting to c’ommon 
writing tasks. Given die 
obvious power and l:>eaeRts 
of Word Styles, Microsoft 
Word 2fXM for Macinto.sh 
introduc'ed a number of UI 
enhancements and 

underlying changes to make 
styles more intuitive and 
accessible, 

Jn Mierosfjft Word 
2004 for Mac, there are 


four Word Style types: paragniph, character, list and table. List 
and table styles are new for Word for Mac, and comprise of 
their own distinct characteristics. These will not he covered in 
any depth in this discussion. Instead we wiU try" to understand 
how styles exist as cascading sets of properties and delve into 
how that might lx; implemented. 


All Your BaseStyle Are Belong to Us 


To understand how a style cascades through descending 
trees of properties, let’s examine wliat a style looks like. The 
easiest way to do this is to (leek at tlie style class defined in 
Word’s object model, 'llie style class is a sub-class of the 
bounding document class. Breaking it out into its properties, it 
looks like this: 


-\ 

Style Class 


Application Property 
Autamatk:allyUpdate Property 
BaseStyle Property 
Borders Property 
Builtin Property 
Creator Property 
DescnplKHi Property 
Font Property 
Frame Property 
In Use Property 
LanguageJD Property 
LangyagelDFarEast Property 
UnkStyte Property 
UstLevelNumber Property 
LisLTemplate Proijerty 
Locked Property 
NameLocal Property 
NexIPatagraphStyle Property 
NoProofiog Property 

NoSpaceBetweenParagraphsOfSameStyle Property 

ParagraphFormat Property 

Parent Property 

Shading Property 

Table Propel 

Type Property 


Delete Method 
LinkToListTemptate Method 

_^_ J 


Figure 2r Word Style Class 

Fundamental to styles is the concept of cascading 
properties. For any instance of the style class, all of its 
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Now I Up to Date and Contact*5 

Caiendar ond Contact Software for Business^ Groups^. Familtes and You. 



Is this project on schedule? When ore you ovaitoble to meet about the systems 
upgrade? Where ore oil the field techs today? When was the last Hme anyone talked 
to our biggest customer? 

Virtually all groups live (or die) by their obilitles to meet deadlines and keep track of 
their customers, prospects, and vendors. Few small companies or even departments 
of big companies have the tools they need. 

Now U|>toDate 8 ^ Contact might just be the calendar and contact software for you. 

If s time-tested and used by more Mac^based componies than any other solution. And 
it's cross-platform-ovaiiabie for your PC users, too. It's easy to install and manage and 
simple for your employees to understand and use. 

Using Now Up-to-Oate & Contoct you can schedule meetings for multiple users, view 
multiple, simultaneous calendars, and reserve rooms ond resources. You can share 
contact informotion about your customers, prospects and vendors. And using our free 
server software you con set it up in minutes and shore with users in the office or from 
anywhere with an internet connection. 


New 

SOFTWARE 


Phone: 866-527-0556 
Web; www.nowsoFtware.com 


Ccii U5 now ot 866-527-05S6 or email os ot mdcfedh@iiow&offwqre.i:om 
" ond we'll send you our free avaiuotfon kit including the book that will 
moke if all easy, ''Toke Control of Now Up-to-Date & Contort'' from 
: Tqke Control booksi ^ 


CopyHghr O 200A by Now SoUwars, IrK. All rights re&ervBii Now Opj-lo-Ddb tuid Now Conlod' oro regtilRfied Ircid&marb of Now Sollwaro. fnc. Moc omJ Moc logo are IrotfeTnoriw ot Appto Compvbr, Inc., 
>rogi£ter#d in lha U.S. and ofltRf counlrios^ All othnr fradtunorlo ockrtowledgod. 

















inheritance is keyed off of UaseSiyle property. Styles do not 
recjuire a value for BaseStyle (in thus case that property is set to 
“none")T hui as we’ll see later, there are computational 
advantages to using it. 

For now though, ieFs focus on what the user sees. If Style 
C's BaseStyle property is Style B and Style B's BaseStyle property 
Style A, then changing an attribute of Style A wiJl casaide 
through Styles B and C, However, there is a pecking order. Let's 
say ilvai these styles are defined tlitisly: 

Style A: Arial lOpt + Bold 

Style B: Style A + Red character formatting, {(Arial lOpt + t^jld) 
+ Red) 

Style C: Style A + Times New Roman ((Arial lOpt + Bold) + 
Times New Roman) 

Style B is pretty' simple - it simply changes tire font cokrr 
property (part of the font class, contained by the style’s Font 
properly) to red. Style C, however has two values for the font 
property. In this case, the sul>-dassed style (Style C) takes 
precedence for the font property. So 'Hines New Roman will Ixf 
tire font for Style C, 

If we now go and ciiange Style A to Apple Chancery lOpl. 
+ Bold + Blue + Italic, wliat will Ix^coine of Styles B and C? The 
logic is the same - again, tlie first thing we need to consider is 
pecking order. The base style will always change the style that’s 
sub-classed from it, unless the hitter eoniains a property value 
that explicitly contradicts a propeity value set in the BaseStyle 
dcfinitioiL So, as in this example, changing the tbni propeny and 
the color property of Style A will not override the settings for 
those properties in Styles B and C. 'Flu" next result then is that 
when we make our changes to Style A, we end up w'iih Apple 
Chancery + lOpt + Bold + Italic + Red (Red tniniping Blue) for 
Style B and 'limes New Roman + Bold + Italic + Blue {Times 
New Roman immping Apple Chancery). 

Mueh like CSS, time invested in cixrating .styles that have 
cascading propertie.s can lie a huge benefit, but if things ever 
l)ec:onie too generi(’ or just don’t work, we: am override any ha.se 
style ]>ro|ierry by setting it as an overriding value in our new style. 

'Ihe style types theiuselves are not neces.sari!y di,sciete iti 
lertns of propen ies type.s either. When applying a .style to, s^iy, a 
diKLiment ciement such as a paragraph^ the .style definition will 
natLirally chiinge iJie projieities of that paragrajih. Moreover, it will 
also encode the charader formatting profierttes that are implidt to 
the .style definition. Similarly, when we apply a table style, it 
encodes both paragrajih and character piopeities (|x:rhaps even 
list propt!rtie.s) to its cell cT>ntent by the naaire of what that content 
is; any nurTilx:r of paragraphs of any number of characters (or "text 
runs”). In essence then styles help us to chan out the hiciarchy of 
a dfK\iment througli chains of elements that fonn die building 
l}l(K:ks of more c omplex elements each of which comes with it 
own set of unique pnjfietlies. 

'I his brings us to our next benefit, and that is one that hel[>s 
both the user and Word’s own internal processing. Because of 
the essential etiology of a style frelng rcxiied in the properties of 


another style, Word chooses to store that defined coUeciion of 
properties just once. To track styles that are based upon other 
styles, Word stores only the differences. 

For the user this provides some nifty benefits. Because of 
the use of both cascading properties and building by difference, 
Word c:an actually strive towards making smart choices based on 
the context in whicli a .style is used. SomeLimes asers get 
confused by this behavior so lefs also take a moment to 
illustrate how this works: by default Word uses the “Normar 
style for all standard text in a document. In Microsoft Word 2004 
for Mac, this style is defined as Times New Roman + 12pt. If I 
now build a new character style that 1 call “Emphasis text” that 
is based on “Default Paragraph Font" (which is the font of the 
default paragrafili style. Normal) and has Italic applied, then that 
wail amount to (Times New Roman + I2pt) + Italic. Applied over 
a paragraph set to Normal style it looks like this: 


Normal Text Emphasis Text Normal Text 


Now wliat happeiis if a user modifies the Normal style to 
make it Times New Roman + lOpt + Italic? What would happen 
to tlie Emphasis Texi style? lechnically, Emphasis Text now 
becomes ((Times New Roman + 12pl + Italic) -h Italic). Bui isn’t 
that second Italic superfluous? In this case, no, Because, this is 
direct formatting that is used in the style to create a difference 
from the base style. Word will take the second application of 
italic, notice that it lias l>een a]iplied to the base style, prcKeed 
to remove italic formatting. Does this mean that ++ ^ ^ and vice 
versa? Not always, as is the case with Word’s internal “Emphasis'' 
style. However, In the most cases of direct fonnatiing option.s 
(such as BokI, Italic, Uiulerline, etc), it does. Let’s get back to the 
purpose of our .style - it was to provide emphasis. When the 
style was designed, Italics were chosen to i>e the delta from the 
base style that supplied that emphasis. By changing Normal (the 
base style) to now also have Italics, does the Emphasis text style 
[low seive no puqmse? Not if emphasis is now instead sui>plied 
by Ihe absence of italics, 'this is a concept many users find 


Normal Text Emphasis Text Normal Text 


dilTiculi to undersuind, but when it's grasped it am make life 
much easier. Instead we can now define styles and think of 
direct formatting as switches instead of liard formatting, 'this is 
certainly not easy with manual formatting, especially if you have, 
say, a jOO page document. 

It is also worth pointing out .some Word Style differences 
between Word 2003 for Windows and Word 2004 for 
Macintosh. In Word 2003 for Windows, a new LinkStyle 
property was added for styles. When seleaing a portion of a 
paragraph and applying a different paragraph style to the 
selection instead t>f the entire paragraph, Word 2003 creates a 
new character style that is “linked" to the paragraph style. Thi.s 
new behavior does no! exist in Word 2004 for Macintosh since 
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our target users preferred tlie existing behavior prior to Word 
2003 . While this is not a major differenee in terms of topical 
usage, knowing the differences here can help explain |X>teniral 
discrepancies when examining styles information when 
working in cross-platform environinenls. 

Hot Properties 

Now that we have observed a modicum of how a style 
behaves, let’s indulge in a little of what iliat means to the 
miernals uf Word, Having covered some fundamemal 
elements of style properties and their rules, it’s exciting to 
examine the implementation of those properties and where 
they live in the global food chain of Word’s internal 
properties. 

Every property in a Word document has an asstxaated 
properly motii/ier (PRM—‘pronounced “PERM"). Each PRM Is 
grouped according to the kind of property it modifies. Word 
has six different PRM grouiis: character, paragraph, picture, 
table, set lion and dcKument, While not six.xifically germane to 
styles, it is worth ntjiing that there are sub-groups of property 
modifiers, for example, one can llunk of list properties as a 
distinct sulj-gmup of paragraph properly modifiers. Another 
exain[:ile would include property mcxlifiers for revision marking. 
We a.ssign an arbitrary value to eac'h of these PRM groups, and 
refer to each arbitrary value as a PRM code (PGC). ^fiile 
the actual values we assign to each PGC are arbitrary, it makes 
sease to assign them in order of frec|uency of use. For example, 
paragraph property inodifiers a|:>y)ear more often In documents 
than table property inodifiers, so tlie actual value we assign to 
the paragrapii PGC slioultl Ix" less than the value we assign to 
the table PGC. 

We can think of a PRM as analogtms to an assignment 
operator, or op-code. 'fhe left-hand side of die DpH:ode is 
the property group that the PRM mtxiifies. The right-hand 
side of the op-code is the argument list asst>ciated with that 
PRM, Returning to the Emphasis Text example, the ctiaracter 
PRM for "italic" has a single argument specifying wfiether the 
“italic" character property should be on, t>ff or toggled from 
its current state. The combination of a PRM and its 
argumcmlsj is known as a property list (PRL—pronounced 
“PREL"), A PRL can be simple, as in the case of the bold or 
italics character properties, or very coiTi()lex, A number of 
property iiujdifiLTs in the rahle group fall into the latter 
category. 

We can pack multiple property lists into a packed array, 
or a group of property lists (GRPPRL—pronounced 
“grouprel"). Moreover, we can sort the each PRL within the 
GRPPRI. according to the PGC of the PRM in the PRL Thus, 
all PRL associated with paragraph property nnxiificTs will 
appear before any character properly modifiers, and 
character property modifiers will appear before any table 
property modifiers. 

With this design, we cm wTtte a simple function to apply a 
given GRPFRL to a properly group, and this function can be 
agnostic to the actual property group l>eing modified. For the 
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sake of Hlustralion, well assLime the existence of four funclitms: 
PriiilTtHnPrh PgcProiiiPrm, CliProniPrl, anti ApplyIVlPgc. Their 
actual im[ilementation is left as an exercise for the reader, hut 
their C/C++ prototypes would r)e: 

PRM PrfflFromPrlIunsigned char *prl): 

// Hxiracts the prnpem modifier from the given pmperty' Usi 

PGC PgcFroniFna{i'R« pm) i 

// Returns the pniperty gn>iip associated with the given pmperty modifier 

fii 2 e_t CbFtotiiFrl{unsigned chat ’prl); 

// Ketiims die count of bytes (Hxupied by the given properly list 

void ApplyPrlFgctvoid 'pyrropertlea, PGC pgc, unsigned char 
*prl); 

//Applies the given I^Rl. to ihe projHtnies of the given PGC 

Our code lo apply a full GRPPRL to a given set of 
properties would kx^k like: 

void ApptyGrpprlPgc(void *pvPcopei:tles, PGC pgc. unsigned char 
‘grppcl* si2a_t cbGcpprl) 

f 

unsigned char ‘prlLlni = grpprl + cbCrpprl: 
unsigned char *prl = grpprl: 

// skip past any FGCys we don't caR^ about 

vhiie ( prl < prlLiiii PgcFromPmtFmFrinPrKprl)) < pgc ) 
pri +^ ChFromPrl(prl): 


// N<iw apply the ones we do ore alxiut 

^hile t prr < prlLiro fcA PgcPromPmfPrinFrQntPrl (prl)) ^ 


pgc ) 

I 

ApplyPrlPgcCpvProperties, pgc, pri)' 
prl ^ CbFroinPrl (pr 1J i 
\ 

assert(pri = prlLim): 

I 

That's it! Though, it should be prrinted out that the actual 
code in Word is both a hit more complex and a l>it more robust 
than this example. For tlie sake of clarity and fur the purpose 
of focusing on styles, weVe left out some details that would he 
iiuportam to an actual shipping applicatk>n. 

WhaCs nice about this design, and very useful when it 
conies tti styles, is that we can enaxle the difference between 
two pro|K*rty secs as a GHFPHL that will transform one propc^rty 
set into the other In order to make this work, however, w^e 
have to have a base set of proj^rties that fonns our starting 
point (our base style). Ihus, Word has something known as a 
StandardPap and a Stanc!ard(!lhp (PAP and CHP lx;ing [laragraph 
and character properties res|xrctively). 'lliere are, in fact, 
standard versions for each property group, bur, as have done 
IxTore, we’ll focus on the PAP and CHP propemy grotifis for the 
rest of this discussion. 

As aoted. each style has a basr? style. The base itself can be 
“none,” which actually means that Lite base firoperty groups for 
the style ace the standard property groups. With this design, 
the work to derive, say. the character properties associated 
with s given style is a very simple, recursive algorLtbru given 
by the following pseudo-code:ChpFcoinStyle(out chp. in style) 
if base from style Is none 

chp = standard chp 
else 
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ChpFromStyletchp, base) 
apply pgcChp GRPPRL front style to chp 

Tile algoritlim to derive fhe full sei of fKiragmph projK^rtics 
from an arbitrary style is left as anoilier exercise for the reader! 

Form and function 

for the reader who finds Mitrostjfi Wt>rd a fascinating tDpk\ 
this discussion has, hopefully, provided the sparks for furrher 
thought. On the inside, we have an exercise in organization and 
reairsion. On the outside, we have a set of cascading staiclures 
uix>n which the savvy user places her trust! 

Applying some of the concepts, it would he pretty easy to 
create an AppleScri[jt tliai showcases the PAP/CHP dichotomy 
while providing a somewhat useful functionality. When 
writing an AppleScnpt code sample in Word, it's hotliersome 
how much formatting it takes to make it look like compiled 
AppleScript. Hi is, of course, is easily remedied by iust copying 
and pasting from an AppleScript editor directly into Word. 
What, though, if I want the AppleScript formatting to be easily 
ciiangeable within Word? Ratlicr than changing my AppleScript 
sellings for every formatting change i want to make (say, 
make comments red), why not create styles for all of the 
formatting tyjxvs that Api>leSeripi c:omm()nly uses. Applying 
those style.s is .mill tedious though, but not if we create an 
a’ript that can do it for as, 

Hte AppleScript jirovided on MacTet lVs ftp site this month 
will do something like that, creating the styles necxled and then 


setting about the rather tedious task of parsing and applying. 
The script itself is rather inefficient, and could be improved by 
the energetic reader. Also, it presumes that the document itself 
is all AppleScripi code, bui could easily be altered to apply tlie 
formatting to a text range or a selection obpecf. Finally, to avoid 
loo muc:h complexity, all variables must lx declared for tliis 
script to effectively Ibniiai variables - but there are smarter w^ays 
to do that too... 

tScript found here 

<http://vwvw.mactech.com/editorial/filearchives.htmb ^ 

As an exercise, the reader shoukl prim fhe script and 
transcribe or copy this script into Word {in Normal). Then 
copy the script into your favorite script editor and run it! Tlie 
resulting Word docoment she mid look pretty close to the 
complied script in the script editor. The avid reader will find 
tlie few minor bugs. 

Once, you've run this script, change any of the style 
whose name is prepended “AS" and watch how the 
documem can change its look very quickly. Once again, if 
this had l>een formatted by hand, it would take hours to 
make the changes that the style can make in one action. The 
fact that tile character propenies (CMP) can co-exisl with the 
jxiragraph properties (PHP) means that I can make one 
paragraph style be the base for all Applescript (ASBaseStyle) 
and formatting by case using niy various character 
])roperties. The character styles laid upon with apply 
formatting to the **Deraull Paragraph Style" which in this case 
is “ASStyle”. AppleScript fun! 

The ability to build a document relies on an 
understanding of those document structures. 'I'hese l>eing 
defined by Word FRM categories form the basis for how a 
document w'orks, not just kn Word, but for the writer. An 
understanding of ihe.se categories leads the individuai to a 
quest for compartmentalization and efficiency within their 
paradigms. I'he bounty of that quest lies nested in the 
cascading palimpsests ()f Styles. As shown in [his article, 
understanding Word Styles is not only vital to understanding 
liow Word works, it can further enable one to take full 
advantage of the power of Word. 

_ ^ 
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Performance Optimization 


Parallel Programming 
With the Intel® Core™ 
Duo Processor 



Extracting maximum performance from your applications 


Introduction 

This is the third and final part of a three part series 
that addresses ilte most effeetivc leehniques to optimize 
applications for the Intel® Core^ Dut) prt>ce,ssor-l>ased 
Macintosh. Part one of this series introtiLiced key aspects 
of the Intel 0)re Dun processor and exposed the 
architectural features for which tuning is most important. 
Also presented in that first article was a data-driven 
performance meihodology using the software 
development tools available on an (ntebbased Macintosh 
to highlight timing and optimization opportunities. The 
second article of this three-part series introduced the 
Intel® Digital Media UtKisl technology of the Intel Core 
Duo processor, its capabilities, and how a programmer 
can exploit this computing power We wrap up the final 
part of this threc-j^arl scries with the most interesting and 
creative aspect to programming the Intel® Core Duo 
pnx’essor - taking advantage of both execution cores in 
the Intel Core Duo processor 

The Need for Parallelization 

Multi-processor workstations have ixen available for 
many yciirs, hk^wever, until recently systetns with more 
than one execution cx)re have been beyond rlie price range 
of the average home user The Intel® Core™ Duo 
pr(x:essor is helping to change iliis. Now parallel 
processing capahiiiiy is within die reach of every user. Tlie 
question that naturally comes up is “Now that 1 have two 
cores, what can I do with them? The slioir answer to this 
question is that you either: 

1 Run more progranis smiultancx)usly (multi-iasking) 


By Ron Wayne Green 


2. Parallelize your applications (multi-theading or parallel 
programming) 

In this article we will take a lotik at tftese two niethocls to 
lake advantage of the additional processing power provided [>y 
a dual-core processor. We will emphasize parallel programming 
models as this is perhaps most of interest to software developers 
interesied in high-performance, scabl>Ie applicaUt>as. 

Multi-tasking Parallelism 

Multi-tasking parallelism is a model where two or more 
prcKesses are created and run simultaneousiy by the OS. This 
follows The creation of the processes is done either 
]>rt>grammaticylly via forkO/execO function calls or often limes 
by simply running multiple instances of the same program 
simultaneously, Ihe pnx'esses cjealed in ciiiier of these 
methods will be scheduletl on the ct)res by the OS. 

This model of parallelism works well when the user is 
performing parametric studies, performing Monte Carlo 
simulations, statistical studies, or where a large iiumixT of job 
runs are used to charatterize a solution space. 1'ypically these 
types of problems use tens U> thousands of input files with 
variations on the characteristic parameters. The same 
executable program is nin as a separate job for each file. The 
goal with this model is thrtmgbjnii, or prexessing as many 
runs in a given wall clock time as possible. 

Where this model is applicable: This model of 
parallelism iDcnefiis from the multiple cores by treating each 
core as an execution unit for each of the separate tasks 
(jobs). However, having the extra processing core in the 
Intel® Core^ Duo proces,sor benefits this modei by 
providing the system with twice the throughput capability 


26 September • 2006 


WWW.MACHCMCOM 










Intego Personal Backup X4 

Back up and protect your digital life 




©ee 


Penonal Backup ^4 


JL 


hTcw 


DocunMf^ 


T«ai rJ» 
49^5 

AwaoeSj»«4 
2e.a mh 




f^dU «€• 


TeCopif 

492« 


Mail Mr Smifli C >pv 5.di»C 


Cq pt t i i 


tnituit Spend 
33.5 


Started on 
ILIi^aZ m 


tenwiing TlUne 
» 30i 


Create and edit backup scripts 
easily and use multiple options 
and exceptions. 


Sack up your data to hard disks, 
CDs, DVDs, IPods, US8 drives, 

I Disks, etc. 


ISftffftCTinfli 

Start and stop your backup task 
with a single click. 


Statistics and 


See the speed of your data 
transfer in real time. ^ 


Personal Backup 






Discover the 3 new fntego Widgets Informing 
you of the status of your protection, available 
updates and scheduled events. 


Easily transfe r and back up 
your data to your iPod. 


Sch^iSe regular or one-time 
backu ps of your data and view 
them In Apple's ICal. 


Easily schedule, check and Install new 
updates for Personal Backup X4, a$ well as 
updates for all Integu iioftware installed on 
your Mat. 


Choose the operaEion you want 
to perform: backup restore, 
clone, synchronise, move, 
and archive your data. 


Select what you want to back 
up by simply dragging and 
dropping it onto the Personai 
Backup X4 Interface. 

Display the progress of your 
backup, as well as information 
a bout the files being transferred. 

View the selected backup script 
option In the scrolling display 
window. 



Main features of Personal Backup X4 


* f uH or incr&me^nta I dtup& 

• Fast, reliable restores 

■ Sinrtup Volume un be rioned 

* Diitdiynichrmi lotion 

" fully and resizable interfile# 

• Arttnive encryption (AES I2BJ 

' New menu Integrating all Integn X4 u>frwam 

• PefKrnal Backup X4 Widget «tnd Irti-ego Widget 

' Predefirtedbfickup scripts for music vtct(»4iiid more 

■ Scrims can be linked ioor>eanother 

* Exception list 


• Date copied In its urlginai format allowing irrmedJatP 
recovery m case of accidentel loss 

• New a^rt management 

• Compatible with Apple Mitomalor 

• View and edit backup Scripts 

• Test Scripts before running them 

• Backups can be launched when no session Is open 

• intego calendar for Apple's iCal 

• ImpriQwed backup stattsterswjdi graphs 

• Badnips can be made ro multiple CDs or DVEH 

• Auiomatfc mount and dismount r/ network volumes 


Vie protecl ybrir wthIH 


llllacworldg^*^- 

ESJOFIHOW ^ 

tixEipiMiizoB perso^ 


Backup 


Madscr 

irvvttv 




vbm 


Intego ‘ 500 toith Capita! of Texas Hway, Suite B-150 - Austin, TX 7S?^46 * Tel (512) 632-0700 • Fax (512) 637-070? • sales@irvtego.com 

MhWpMVMk. W USp*! KUtei LBWHn.e mr llr Hrrfiii«)lU-knjlD90«a rt^uutnljcui waU n nvxnnl MMiwtea ntXimd 

M <hr vs Kid bWt unpirvL U cittw bfni hkI piodwjl num fir Hhi nW Iw MiTnuriS iX «>«! thpT Hi iMPtibll « WMcA fH, MW ilMlitt kMUa h tin IHlWioe^ tf fnDtii ki i* |rtr{iit)r^|i<,^ rutt-i ir««t)u 


# 


Mac 


UnivKfsal 


Apple Store hktfMaR ‘1^^% [■BHSgSfpl www.intego.coin 













































































over a jimgle-core system. This model should be 
straightforward and familiar 

Parallelization via Multi-threading 

'Ihe remainder of this article focuses on multi’threaded 
programming techniques. These techniques enable a single 
program to CTuale multiple threads of execution. Ihreads are 
scheduled equally on available executit>ns cores providing 
increased application performance. 

Parallelization via 
auto-parallelizing compilers 

Auto-panillelizing compilers attenifH to analyye prognims and 
automatically generate pandlel code. As far as ease of use hr llie 
pitjgrammer, lliere is nothing ejtster than taking an existing serial 
code and allowing ait auto-fxirallclizing a)mpiler to genemie pa ml lei 
axle. 'Ihere is an del saying tltat applies here: If stamiliing seems 
t(X3 gcxxl to Ix' true, ii proltably is. Creating an auto-pa nil lelixing 
compiler lltat produces elTicient ctxle in all cases for a wide vaiiety 
d app!icati(tas has proven to lx a very diRicuti task. Tlius, auio- 
parallelization reiruiias a hot resetirch topic and the ixifect duiiy 
parallelizing cTompiler is yet to he paKkiceci However, there aa^ 
some cases where auti>paraIlelization is pcrfc'clly suited. 

let US examine the auto-ixinillelization capabilities of the Intel 
Fortran and C++ Compilers for Mac OS, Both these compilers 


supix>rt auto-parallelization. In addition, these compilers have to 
capability to produce a jrarallelLzaiion report, AuUvparallelizJng 
compilers are most effective at very srmU, tiglit, uncomplicated loop 
slruciures, Ttiere are some appliattioas where the majority of time 
is spent in a tiglit little unajmplicated loop. Consider the code 
example shown below which we save in a file named ‘'heat.1%’* 

1 program heat 

2 

3 real, dimension(500,500)* target m plate 

4 real, dimension(498,498) n€w_inslde 

5 teal, pointer, dlineiieioti( j * s) ii n, e, s, v, inside 

6 real ;: dlff 

7 integer i,j, niter 

a 

9 I Set up initial conditions 

10 plate = 0 

U plate{l;500,1) “1.0 ! boundary values 

12 plated,1:500} (/ ( O.Ol’j, j = 500. 1, 1 ) /) 

B 

14 1 Point to parts of the plate 

15 inside => plate[2:499*2:499) 

16 n plated :498,2:499) 

17 s -> plate(3:500,2:499) 

18 e “> platei2:499.3:500) 

19 w => plate(2:499,1:498) 

20 

21 wrlte(*,‘) “’Slatting iterations" 

22 do 

23 riew_inside =" (n + s + e + w)/4,0 

24 diff * maxvaltabs(new.inside-Inside)) 

25 inside - new Inside 

26 if (diff < 1,0 q- 4) then 

27 exit t,.. exits the do loop, not the pro grain 

28 end If 

29 end do 

30 writeC*.*) ““done" 

31 end prograni heat 
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Tills exiimple is a lii^hly simplilkd 2-D heal tnmsfer prd^lem. 
In tliis example we siniLilate a 2-D plate of material with some heat 
applied to two edges, For simplicity we assume that this initial 
ix)undaiy eondiiion Ls maintained. The purpose of this example is 
to simulate tiie heat transfer over simuiated time from the edges of 
the plate into and acrtx^s the plate until steiidy state is leaclied. The 
general rnethcxl to simulate the heat transfer Ls to divicle the plate 
into cells. In our example, wc divide the plate into 500x500 cxflis 
lepresented by the army elements in plate. Fcxusing on a single 
we assume ihat the heat eneigy in a cell at time I'+l is tlie 
average of tlie heat eneigy at time T in tire four neighhiring f:ells in 
the north, souili, east and west directions. The syntax for this is: 

new ” ( old (north) + aid (south) + old (east) + old (west) ) / 4 

or 

new_energy{ i, j ) = ( oldC i t. j 1+ o3d( i+Uj old ( I.j+1 
)1 old{ T,j-1) )/4.0 


Which we can visualise as .shown in Figure 4 below 
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time! 
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time T 
i+l, j 



Figure 1. Energy for cell (i,j) at T+1 

lliis example may take some consideration ii^ you are not 
familiar with mcKlern Fortnin 90 array syntax and pointers. Let's 


examine this cxxle. On liae 3 we declare a 500x500 element array 
named plate. In Fortran 90^ pointers can only point to variables 
witli the TARGET attribute sus we .sec^ in this declaration. Tlie variable 
plate will hold the aiment, or time 1', eneigy values. On line 4 we 
declare a second array named aew_inslde that will used to 
store tile new values inside the plate, the time T+l valuers. The 
iaside of the plate excludes the boundary cells which are assumed 
to be fixed energy and will not change over simulated time. 

Keeping in mind that Fonran 90 pointers can poini to array 
sectioas, we set up a pointer mimed inside that ]X)ints to the 
non-boundary elements of plate. These are rows 2 through 499 
and columns 2 through 499. Thi.s is clone on line 15 in the code 
example and can be visualized by die diagram below. Keep in 
mind that pointer variable Inside is pointing to a subset of the 
same memory as plate. 

_ Ptat&( 1:500, 1:500 ) 



Figure 2. Pointer "inside" of "plate" 

Now, visualize taking ihLs inside ^xaion of plate and shifiing 
it J cell nortli. lliis is what the [xnnter variable n (north) is set to 
w'ith the statement on line 16. We do a similar initialization for the 
variables s (south), e (east), and w (west) on lines 17, 18, and 19 
lesyxrctively. Tliis can lie visualized as shown in Figure 3- 
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plated.500,1:500) 



e plateC2:499.3:500) 


ptate( 1:500,1:500) 




s=> p!ate(3:500,2:499) 



plated :S0&, 1:500) 


W=> pl3teC2:499.1:498) 


Figure 3. Pointers for north, south, east, and west 

LcK>kin^ al the exaiii]>le cDcle, on line 22 starts a do lc.x>p that 
simulates the time steps for the simulation. Note that tlie exit 
criteria For the simulation is handkxJ in the conclitional c}n lines 26- 
2H. Tfic bulk of the work then is contiiined in the statement: 


baseline run. For tliis example we use -02 which you wiD recaU 
is the default optimization level when -O is not specified, 

ifort -0 heat -02 heat.f90 
$ time ./heat 
starting Iterations 
done 

real 0iiil7.6l4s 

user 0 tii17.555s 

sys 0iiiG.025s 

To autO’parallelize an application with the Intel Fortran and 
C++ compilers for Mac OS, we use the -parallel compiler 
option. 'Ihis causes the compiler to kx)k for parallel i7,jition 
opportunites on an entire source file. 

$ ifort '0 beat '02 -parallel heat.fSCI 

heat.f90(23) : (col. 2) remarks LOOP WAS AUTO-PAEALLELiSiED. 
heat.f90t24) : (col. 9) remark: LOOP WAS AUTO-FARALLELIZED. 


Note the remarks for lines 23 and 24. lliese indicate that the 
Fortran 90 array syntax was recognized and parallelized. We 
now run this parallelized version of the code. 

$ ,/beat 

starting iteratione 
done 

real Omll.422s 

user 0in22.2B4a 

sys 0ti!0pl93fl 


nev_iiiside “ (n + s + e + wJ/4,0 

I'his seeLiiiiig simple statement does an elenient-hy-element 
addition of tlie cells pointed to by n, e, s and w. Alter some snicly 
you will .sere that ihis d^x.^s ihe etfuivaleni douhlemesied I(X)p: 

do 1=1,498 
do j=1.495 

new^insideti-j) ^ ( n(l.j}+e(i,j)+wCi,j) )/4.0 
end do 
end do 

Tile nexi interesiing siaierneni, line 24, lakes advaniage of the 
fact dial Fortran 90 intrin.sic functions abs and maxval can 
operate on array operands. The statement: 

diff = maxva1(abs(new_inside inside)) 
will find the altsolute values of die dirierences between the new 
energies ( riew_inside ) and the old energies C inside ) on 
all cells. This re.sult of die ahs funcrion is an array of shape ( 
1:49H, 1:49H ). This array then is llie argiimenl to MAXVAL 
instrinsic whicli will return the scalar value of the maximum 
valtie of lliese differences. Tliis we store in the sr^aiar variable 
diff which is then used to dcLcrmine when llie difference 
IxTween the old and the new energies have reached a threshold 
when we can assume that the plate has reached a steady state. 
Again, this same fumiionaiily could be implemented wiUi a 
double-nested loop. Obviously tliis example ignores many 
thermodynamic pnnciples such as realistic time steps and 
thermal conductivity constants. Still, it is representative of many 
iterative approximation melhtxls. 

lb test tlie efficiency of the auto-pamllelization capabiHties 
of the Intel Fortran Compiler for Mac OS, we first need to do a 


The wall dock time is showai <)n die line labeled “real". Keep 
in mind that tlie “user" time reflects the time spent on BOTH 
cores added togetlier, Before parallelization the real time was 
17,6 seconds. After panillelizaiion this was reduced to 11.4 
seconds. When analyzing the imiirovemenl, a value called 
Speedup is used. Speedu]]) is calculated as: i 

SpeBdup “ f Time SBquBntlal ) / (Time parallel) 

Wliich for our example gives: Speedup = 17.6 /11.4 or 1.54. 
'this is a 54% improvement. So is this acceptable? Keep in mind 
we u,sed a c'rude wall ckx'k measure to gauge our perfonnance. ' 
Tills included application startup and teardown overhead. Alst>, 
when exiimples run for short periods of time such as this example 
ihere i.s not enough W'ork in die parallel regions to amortize tlie 
overiiead costs of thread aeiUion, dispatch, join and teardown. 

We also have to look at the return on investment - how much 
effort did ihi.s take? We goi a 54% speedup out of a simple 
compilation and link with zero clianges to die source code. Quite 
a good return on investment by any measure. 

Fnim this example, the primary limitation of auto- 
[laralleiization may have liecome apparent. Auto-parallelization 
is applied to an entire source file, 4Tiere is no method to control 
which loops or array ,syntax ecjuivalents are parallelized. In 
stime ca.ses the loop may lie purallelizcd l>y may not have 
enough work to amortize the cost of the parallelization 
overhead. Tlius, it is not uncommon to find cases where an 
auto-parallelized application actually slows down relative to it’s 
sequential counterpart. To help determine where this is 
occurring, the Intel Fortran and C++ Compilers provide a 
parallelization report capability. This functionality is enablcxl 
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wilh ihc -par-report aniipiler oplion: 

Synfax: -par-reportjrf] 

Arguments: n is the level of diagnostic messages to display. 
Possible values are: 

0, No diagnostic messages are displayed 

L Diagnostic messages arc displayed indicating loops successfully 
auto-parallelized 

2. Diagnostic messages arc displayed indicating loops sucecssluily 
and unsuccessfully auto-parallelized 

3. The .same diagnostic [iiessages arc displayed as speeifted by 2 

plus additional infomiation about any proven or assumed 
dependencies inhibiting auto-parallelization (reasons for not 
parallelizing). 

Where this model is applicalile: Auto-parallelization is most 
effective for c tKJes with veiy simple, (ighi looping srniaures that 
are easily idenLiriai)le by the coiripiler. Keep in mind that a 
profile of your code should identify that the majority of run time 
should be in these tight kxjps. Anto-parallelizatinn is performed 
at tile sr)urLe file set^pe. Tlius, it is most effective for mfxjular 
eode, Auto-paralleliz;ition should he applied selectively since in 


some cases it lias Iseen shown to negatively affect runtime 
performance. 

Parallelization via parallel libraries 

There is a class of applications that spend the majority of 
runtime in cx>nimon function calls. Tx)mmon” in this cx)ntext refers 
to a hinction designed to solve widespread or well-known 
mathematical operations or data processing tasks. Examples include 
mairix t>perations and manipulaiions, fast Fourier transforms, image 
processing, video and audio encoding, encryption, signal processing 
and compression/decompression. And 1 cannot re[ae.at the 
h)llo(wing advice often enough: profile your application and km)w 
wiiere it is s^x^nding time. Tlien examine tfiese progitiin liot sptjLs 
and look to see if diis hex sfx>i is performing sometliing very 
common. 1 am consiantly amazed at how many applications a^niain 
hand-coded matrix srdveis like matrix-matrix multi plication, 
eigenvalue ailculation, matrix inversion, etc. Also commonly found 
in user applioitions are user-written 2-D or 3-D fast Fourier 
transforms. Perfonnance of user written functions varies wildly. 
However, in alimjst all ctises the performance of user written 
ftinciion.s is suhsiandard when comp;ired to piofessionally written 
and tuned libraries from vendors. 

It is alsf) cr>mmon for apjilicatioas to rely on freely distributed 
.source libraries such as BIAS, lAPACK, Atlas, :ind KFl^W, to name a 
few. These libniry implemenration.H are available for download in 
.source fomi and are then compilexi by die tiser and linked into an 
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application. WMe these libraries often outperform user writicn 
code, they are typicially not tuned for a particular Utiget platfonn. 

In Iasi inontli's article we introduced the Intel® Math Kernel 
Library for Mac OS {Intel® MKL). We mentioned that Intel MKL 
provides functions for linear algebra ( BLAS, LAPACK, sparse 
solvers), fast-fourier transforms (I'lTs), vector math libraries, 
and vector statistical functions. In addition to being highly 
vectori 7 ed, many of the Intel MKl. routines libraries are intemally 
threaded. Thus, a sequential application can call an Intel MKL 
library routine and that routine will automatically spawn direads 
and split the work across the available cores. 

Where this model is applicable: lliis model applies to 
code,s that spend the majority of dieii’ runtime in common library 
routines. In this mcKlel the programmer does not need to worry 
alxjut manually parallelizing tlieir application, diey simply rely 
on the threaded parallel library function to leverage the available 
cores. Again, this model works best when the bulk of tlie 
application runtime is consumed in common library routines. 

Parallelization via openmp 

OpenMI^ is an application program interface (API) that 
provides a ineaas for specifying parallelism in C++ or Fortran. 
OpeiiMP is a multi'platform, vendor-independent .specification for 
a set of crimpiler directives, library routines, and enviromnent 
variables used to S]>ecify skired memory panillelism. It is a widely, 
readily available, flexible and relatively easy to learn. OpenMF is 
stipponed by an independeni oigani/iiiion iliat can l>e found at 
http://www.openmp.orQ . In addition, there are several hoolcs and 
m;iny online tutorials and examples that am be used to learn 
OpenMP pri>grainming, A full description of 0[>enMP is far beyond 
the scope of this article. Instead we examine an example Ojx^nMP 
application, describe how to build and mn the application, and 
examine pedbrmanee on a dual-core system. 

OpenMl^ is not a computer language. Rather, it works with 
an existing Oj^oMP capable Fortran or C++ compiler, line Intel 
Fortran and C++ Compilers for Mac OS su|)|x>rt tlie OpenMP 
version 2.5 API specification. OpenMP allows a programmer to 
specify ]>andlelism at the loop level. This is done by adding 
pragmas (C/C++) or coinpllcr directives (Fortran) to existing 
source code. The advantage of this design is that non-OpenMP 
compilers simply ignore the pragmas or compiler direaives. 
'I'lnis only one source needs to be maintained for lx)th OpenMP 
and .He(]uentiaJ targeLs. 

Let U.S begin our exploration of OpenMP by examining a 
serial application; 

1 ^Inclade <stdio.h> 

2 int mainO I 

3 int n, i; 

fi double s\m. pi. x. h: 

5 

6 n = 1000000000: 

7 h - 1,0 / n: 

S mm = 0.0; 

9 printf [‘^starting \n"}: 

10 fpt ( i“l ; l<n : i++ )l 

.11 X - h M i'0.5): 

12 sum = sum + (4.0/(l.0+x^x)); 

13 1 
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lA pi “ h'sum: 

15 printf(“pl is %f \n*‘.pih 

16 1 

Wilhoiii going into a lot of detail, this program calaibtes an 
estimate for the value PI l)y iniegmiing iltc function RX) = 4.0 / 
{ 1 + X^2 ) between tlie valties Q <= X < 1,0. Hits uses 
trapezoidal rule for the approximation of the integral. 

Again, we generate a baseline nm at -02, this lime focusing 
on the wall clock or “rear time: 

iec -0 pi -02 pi.c 
time ./pi 
starting 
pi is 1.141593 
real Oral 5.669s 


Now we exaTiiine an OpenM? version of tills siiinc code: 

1 include <stdio.h> 

2 

I int roairtO ( 

4 in t n, 1: 

5 double sura, pi, h : 

6 n - lOOOOOOOOO: 

7 h - 1.0 / n: 

6 sum * 0.0: 

9 printf (“starting \n''): 

to Ipragma omp parallel for privateCl^x) shared(hi 
reduction(+:sura) 

11 for £ i”l : iCn ■ i++ ) ( 

12 X = h * ( 1-0.5): 

13 sura - sura + (4,0/(l.Otx'x)): 

14 I 

15 pi - h‘suni: 

16 priiitf{“pl Is %f \n'*,pl)i 

17 I 


The only differcnc'e in this version of die program IVom the 
serial version of ilie piogram is the OpenMl^ pmgim at line 10. 
'Ibis pragma tells the compiler that the C for loop that follows 
should ix: parallelized. Ttiis defines what is known as a parallel 
region. Tlic iterations of tliis for kxip are split equally amongst 
the available threads. For a dual-core processor, two threads are 
created by default. Tlie first thread wQ] prcx:ess !tK>p iteratitms 
n=l ilTOUgh n/2 -1. The second thread will process loop 
iterations n/2 tlirough n. 

The private, shared, and reduction clauses control 
sharing of variables within the loop. Tlie private clause 
specifies variables that are owned created and owned by each 
thread and arc not shared. The variable h holds a value that is 
sSliared by the two direacls. Finally, the reduction clause 
specifies that each thread will get a private copy of the variable 
.sum. On exit from the parallel region the separate copies are 
comiiined with die operation. 

To compile an OpenMP program using the Intel C/C++ or 
Fortran Compilers for Mac OS the - openmp compiler option is used: 

ice -o pl_omp 02 -openrap pl^orap.c 

pi_orop.cC10) ; (col. 1) remark: OpeiiHP DEFINED LOOP WAS 
PAKALLEUZED. 


13y default, wlien we run diis program we will create one thread 
for each core in the processor. For an InteKg) Core™ Duo 
pr<x:es.sor, this will lx: 2 threads. For an Intel® Core™ Soki 
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processor, this will lie 1 thread. Thus, on an Intel® Core^“ Duo 
processor Irased system we gel ihe following liming: 

$ time ,/pi_omp 
starting 
pi iB 3.U1593 
real 0tiiS,4Zls 

Calculating the speedup ( 15.669sec serial vs. 8.421sec parallel) 
we get: 

Speedup = 15.669 / 8.421 ^ 1.860 or approxirnaiely 86% 
s]x;edup 

OpenMP also allows a programmer to am an executable 
anti force a non-defauli number of threads. ITiLs is done by 
setting the OMP_NUM_TllREADS cnvironmenl variable. Fcjr 
example, we can run tliis same executable on one core by 
selling OMT^_NUM_THREADS=t and simply retiinning the 
program (no recoin pi lalion required); 

export OKP.MHM„THRFAnS=l 
time ,/pl_omp 
starting 
pi is 3.141593 
real 0mI6.651s 

C^ollcTiing our resulLs for a two-core sy.stem we see: 

Fi serial; 15.669 (seconds) 

OpenHF FI run with 1 thread: 16*651 (seconds) 

QpenMF FI run with 2 threads:. 8.421 (seconds) 

Note that the 1-thread OpenMH case has about a 1 second 
overhead compared to the non-OpenMF version of the same 
code. Tills is ovcrlicad as.sociated with initial prcx“es.s startup and 
parallel region overliead even when we do noi use more tlian one 
thread Keep in mind that this 1 second overhead would lie 
considered “noise" in a real-world, longer-running applicmion. 

Where this model is applicable: OpenMP provides 
parullelizadon of looping constructs (for, DO, etc). This 
model IS apj)licable \o u.ser codes where the majority of 
runtime is consumed inside loops. Unlike auto- 
parallelization, these ioDping structures can be large and/or 
complex. This makes OpenMP applicable to a large number 
of applications. Because of this, OpenMP is considered by 
many to be rlie method of choice for portable, flexible and 
easy parallel programming. 

Parallelization via explicit threading 

POSlX(S) Tliread^s programming, or more ccimmonly know^n 
as p'llireads progmmming, uses explicit API calls to create and 
manage user threiids. This is the most low-level parallel 
programming melhtxl presented in this article. To understand 
this model, we take the PI example alxive and prcsent a 
pThnead implemeatation: 

ifindude <stdiy*h> 

#inciude <stdiib,h> 
jintiude <syfi/types,b> 


//include <pthread*h> 

//define TfiREAES 2 
#define N 1000000000 
typedef struct ( 
int id: 

I partn; 

double sura[THREADSJ * h: 

void *Calc_Partials(vold ‘arg) //thread function to calculate 
partial sum 
I 

tnt niy_thrcl; //thia thread's number ( 0 through 

NUM_THREADS■1 ) 

Inc Trty_icers; //number of iterations for each 

thread 

int ray_atact. ray_end; //iteration start and end for each 
thread 
int 1: 

double X, local_au]ii: 
parin *p=[parjii Darg: 
jny_itera = H / THREADS: 
iny_thrd = p->id: 

my_starC ^ (i3iy_lters * niy_tbcd) + 1; 
iny_end = ray_itars * (my_thrd+l): 
for ( i=niy_start ; i < my_cnd ; itf ) I 
X = h • C i-0*5): 

local sum = loCx^l_Huin + {4 *0/{1 * 0+x'x)}; 

1 

SLira[iiiy_lhrdl local_suJii: //store local partial to global 
pattlui 

return { HULL ); 

I 

int maiullnt atgc, char* argvfl) ( 
int n,i: 

pthread_L ‘threads: 
pihread„atLr_t ptbcoad_cut>Loiit_actr: 
parm 'p; 

h “ 1*0 / S; 
threads“(pthread _t 
*) Ilia Hoc (THREADS *sizeof (‘threads) 3: 

pthread_attr_inlt; (&pthtead_custofli_aL tr): 
p"Cparin *) iiialloc (s liteof Iparra)‘THREADS): 

/' Start up thread */ 
for Ci^i KTHREADS: i++) t 
p[i].id“i: 
pthtead_createC 
^threads fi), 

& p tb r ead_e lis t oin_a 11 r * 

Ca] r_Fart ial a, 

(void •)(p^i)): 

I 

J* Synchronize the compietion of each thread, */ 
for Ci=0s KTHREABS: i++) 
pthread_join(threadBUJ *NULL): 

printf{ '"pi is 14if\n''. (sumfOl+sumfll)‘h); 
free(p); 

I 


Running this example we will use 2 threads. These will 
each get scheduled on each of the execution cores of the Intel® 
Core’^*^ Duo processor* 

time ./pl^pthreads 
pi is 1.141593 
real OmS.123s 


which is very similar to the Oj>enMP time of 8.421 .seconds for 
the same problem. 

Tliere is obviously a lor of detail that could lie discussed in this 
example. One immcxliate observation is rliat lire pThreads version 
of the PI piDgram is considerably more complex than tlie OpenMP 
version* In pDireads pfogramming, tlie threads are dispatched via 
tlie pthread_create() funaion call. Tliis call creates a tliread 
and dispatches it to a user-written function, wliich in tlus exiimple Ls 
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named Calc_Partials 0. You will recall dial Opc‘nMP Is a 
method to parallelize loops, 'llius pllneads piogramming provides 
a mom eoarsc level o( prallelism than OpenMP. 

Where ihLs model is applicahle: This model is most useful 
for applications that do not necessarily have loop structures to 
parallelize. Certain applications do not have clearly defined hot 
spots or hot loops. Rather, these applications may have a deep 
and complex call tree, or speed a lot of time in 10, or have a 
need for bat:kgroiind processing. Or perhaps there is a need for 
nun-symmetric parallelism. In cases like this, one thread may 
run function A while the second thread performs sometliing 
ct>mpletely different in ftinciion B, In these ways pHiread 
programming provides the greatest llexibiliiy of all the methods 
presented at tile cost of increased program complexity. 

Summary 

The Intel® Core^” Duo proce^ssor provides parallel processing 
capability at a very alToakihle cost. This Is sjxiwning a demand ft^r 
applic’ations that can utilize tlie extra processing capability. 
Developers are resp<jnding by taking at kx>k at dieir appliaitioas 
and determining how lxf.st lo parallelize their ccxle. Tliis anicle 
presented an introduaicjn to jxiraJlelization meiiiods. Tlieie Ls nt> 
ojie model tliat is universiilly applicable to all appliaitioas. It is 
ho|x.‘d this overview will allow you to analyze your appliaiiion and 
tletennine wliich method will work IxfSl for your ajiiilication. 


Further Reading 

Examples shown in this article are available for download. 
Please visit the MacTeeh source ccxle ftp and select this month's 
issue, 22.09 : 

http://vwvw.maaech,coni/edltorial/filearchiye5,htm 

There are many outstanding books in parallel programming techniques, 
OpenMR and POSIX© threads programming. The following list provides a 
starting point but is by no means a conclusive list 

A good starting point for understanding the Intel® Core^'^ Duo 
processor and parallel programming models is Multi-Cpre Programming. 
Shameem Akler and Jason Roberts, Intel Press, ISBN 0-9764832-4-6. 

OpenMP tutorials and examples are readily available online at 
www.openmpora . In addition, this v/ebsite has lists of several very 
thorough books on OpenMP 

P05IX® Threads programming information can be found in several 
books. A good starting point is Programming with PQSIX(R) Threads, David 
R, Butenhot Addison-Wesley Professional, ISBN 0201633922. 

iWi 

About The Author 

Ron Wayne Green is o member of Ihe Intel Compiler team. He has been involved 
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Automator for Administrators 

By Philip Rinehart 


Automator 

Witli tlie release of Tiger, a new utility was added to the 
normal suite of Apple applications. Automator A grizzled system 
administrator at tliis point might ask, so whal? What can it do to 
make my life easier? Tlie answer lies in the original project name 
l>cfore Tiger was released, pipeline. As system administrators 
know, a pipe Ls a very quick way to chain evenis iogether from 
the command line. IJeginning to see the connection? 

One line from tlie Apple Help documentation sums it up 
best, “Automating repetitive tasks can save a lot of lime and 
effort". While most AuLomator tasks dial are siiipjx^d with 
Macintosh OS X are Application specific, they don't do much tor 
the system administrator, let’s begin the jtjurney by examining 
an action in the System Automator actions. 


First, die action neetls some input to work with. How would 
a system administrator start a pipe From the coiriinand line? Is 
springs to mind, as often as a system administrator is working on a 
set of files. Tills action can te mimicked in Automator by using the 
Get Specified Kinder lU^ms action. Figuix: 2 sliows an example: 


. 



Any result from this action is passed to die Do Shell Script 
aulOTiiaior action, wiili the path listed above, and you perform 
the entered shell saipt c^n the item. 


Using your scripting prowess in a new way! 


RUN Shell Script 

Hie first action should seem familiar, as it is similar to the 
do shell script command that has existed in Applescripi for 
somt' lime. With the 10,4.2 update to Madniosh OS X, the Run 
Shell Script action was added to the suite of Automator actions. 
The Run Shell Script does exactly as its name implies. It nin.s 
a .shell scTipt. Tlie default action when added to an Autoniator 
workllow LS shown in Figure 1. 



Shell; ' /Wtt^basti * j PajJ inpui; ’ [Qinflfl *1 


eat 


TtJtl J 

Figure 1 

When a .system administrator whies .shell scripts, a she Ixmg 
I is used as iFie first line of die script to tel) the system wliat to do 
with the text. Automator automatically interprets the script tor you, 
deFaiilting to the ba,sh shell ITie adion even g<x"s one step funhcT, 
including some common shells, esh, tesh, sh, zsh, ksh, 
and two programming languages, python and perl, vSony, ruby 
fans! By default, the action lakes input as if it weie being sent 
directly from stantkird input. The last option, Show Action Wlien 
Run opens a dialog, allowing the user to change the options as 
entered in the adion itself. However, before examining this 
particular option, let's create our first workflow. 


Next, drag the Do Shell Script adion as shown in Figure 
1 f)eiic-atli the Get Specified Finder Items action. Instead of 
using the default Pass Input method, change the method to as 
arguments, Ir will Ixrcomc dear why this change is preferred 
in a moment. As the action uses bash as its default shell, enter 
Is -1 $0, This will reriirn a long listing of the folder 

/Usera/Shared, Try it out! 

But the action runs, the .submarine sound plays, and 
iw'o green check boxes appear. However, there aren’t any 
results! How does one gel results? .Simple, add the View 
Results to your action as tlie third item. Once added, the results 
will he passed as text, allowing your action to be checked for 
accuracy, 'lliis action is typically added when developing an 
action, but not used in the final production workllow. 

The Do Shell Script action is tiseful, hut there are some 
important limitations. If Ihis action is saved as an automator 
application, it will simply nin but pre.sent no tangible result. Not 
very useful. The action could be saved as a workflow^ l>ut that 
allows any user to alter the content.s of the at:!ion. At Ixrsi, the 
action will simply fail or produce unpredictable results. At 
wor.st, it has the potential to destroy the contents of a user’s hard 
drive, rin -rf anyone? What a .system administrator regally 
wants is the ability to create an action for the environment that 
they administer, with any customizalions needed. Enter Xcode. 

THE meat of it 

Xcode 2.1 and Shell Script Automator Action 

Xcode 2.1, introduced at WWDC 2005, added the aliility to 
create a trusLom .sliell script action. Tlie mind leels at the 
possii>ilities! Since then, Xcode has been ujxlated to 2.2.1, 
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fixing; some bugs along the way, 'Hie custom shell script action 
is creaiet! as any Xcode projea Is, simply l)y selecting New 
Pn>ject fn)m I lie File menu, and Aen selecting the Shell Script 
Automalor Aaion. The action w^ill be created with an Xcode 
template as shown in Figure 3- 



^ [3 «!!««•« 


-T'X’mk' 





^ ^ iMd hultt 


^ jttimmnt.iicttaii 

CKUtkviitttOfV 
loviNMU^n •ftimcHeA 

:ig(j 

I ^ bifi^ni^t.itrin^ ^EngJlfW 
ni4tiLRlta (Enfitilii 


Figure 3 

Xcode will create a number of files by defauii: 

•uutomaLor.action (the pixxiuct) 

• inainx'onunand 
I* nfo.plist 

I* nfnPljKt,srings CFnglish) 

• mainmih (English) 


as well as linking the required frameworks to Ixiikl the action. 

Parts is parts 

While Xcode may Ixf familiar to programmers, or those who 
liave dabbled in writing Cocoa or Carbon programs, many 
system administrators may not as familiar with tfie interface. 
The first file we will examine is main, command. Double click 
on the file to open it. Figure 4 shows the window that appears: 


r>no 


mam command 


C3 






Build Build aMlCa 

^ ' u nuin T. 

tl^\itr/bWinv tfi 
t 

i out^tfftor 


« %/vm^ 

■ CofiyTtglit 2806 „FM:iiDrifHrfltiM* Ail r^erMd, 


ia O 

J*rei6ct iMgrauptif 

■^1- ■ *’» ii 


Figure 4 


Look familiar? This file contains the shell code used in 
the Automator action. Note that the she bang is included, 
and by default uses sh (an alias to Ijasli in Tiger), However, 
you don’t have to use shell, you can use any available 
language on your system, ruby, tcl, whatever suits your 
environment. 

As witii any site!I script, it can be considered best practice 
to add the PATH environment variable. Additionally, T usually 
add the tbUowing for ,secajrity and dci)ugging: 

set 

exec 2>^dev/console 

echo starting action.*, 1>&2 

printenv 1>S2 

IFS-" 


Although we are talking about Auiomator, this shell 
prologue could be used for any shell *scripl that is being 
written in the bash shell, lire first line, set -xv turns on 
veriK)se mode, and also expands each command. Next, all 
otitpui is sent frt)m stderr to the console, which is useful 
in debugging aotaniator actions. The following two lines 
simjdy pul some information content inio the console. The 
la*st item protects the Input File Separator (IFS) from 
improperly formed input, a y>oiential security risk for any 
shell script. 

Figure 5 shows an automalor aciion using the prologue and 
*setting ihe PATH variable. 

___^ 

\ ^ 

ttM : t _ 

! mi 

I 

tmMi i«i 

4 I* •f'Jt lip 

■ « Cwt#*. , ' ■ f IL I 1 ^-, 411 wtmt rrmwm. 

lA HH 

■M iM n4.- 

uripiw ii4; 

JIV 

m i*MMI * /Iwnwlb 

iirtpInC !<«•>> 

IW I I* -||4A^1t«]}- 

m 

tr [ fuRi4 .#11 ] 

IIM 'tr .mm jnrt- 

Figure S 

Take it for a whirl. Create an automator action, enter the 
prologue code and build and nin. What iiappen,s? Open the 
Console, the environment should appear avS shown by 
printenv, as well as a “staning action.,*" message* 

BUILDING the ui 

When you build a project, a default user interface is built 
for the project. Double click on muin.nih. Figure 6 *sliows 
main^nib* the default IJT, 


B ..B. 

. -* •!> r, 4 
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Figure 6 

Pretty hare, and not very u.seful, iL’ 

First, add the CtK.’oa-Auloniittor Palette to XCnde. The 
proeess is not too complicated, but ckx?s retjuia' knowing all the 
right steps. Here’s hm to add it; 

1. Chtxisc the Palettes Menu 

2. Select Palette Preferences, A window will open. 

5* Click the Add... liuitoo 

4. Select the AM Palette, palette in /Developer/Bxlras/Palettes 

A new palette will apjxMtr with the Aiitoinator Icon. Tltis 
palette can be used to add three types of actions to the cusioni 
action. The U1 also accepts any other ol)ject from the Interface 
Builder palette. All the siancJLird Interface Builder Riles still 
apply, including Human Interface Guidelines, backgrtHinds, ei 
id. When finished, be sure to Sitve the fde, usually niaiii-nib, as 
it is the interface of the cu.siotii action. 

Connecting the U1 

Once you have created the Ul. how dttes the 
main.coniinand file know afxjut the comrtjfs you have created? 
Bindings! Not a Coetta programmer? No matter, bindings in the 
context of creating a Custom .Auioimior Action are pretty simple 
to use. Back to tlie ML Open main.nih in Interface Builder. If 
the Inspector is not open, open it from the Tools menu. '1V> 
make this prtRcss clearer, here's a step-by-step walkthrough. 

Step 1: From the Aiitomator palette, select the Directory 
Chooser button. Drag it onto the IJI and fKJsiiion it. The 
Inspeaor pane shimld l>e similar to Figure 7. 

Step 2: Select the path triangle, anti expand it. This 
panmieter hinds a value tor use in die main* comaiand file 
Step 3^ Enter a name in the Model Key Path field. It can 
be any value that makes sense, for rliLs example, enter 
di rectory Pa th. 'Ihe value i.s criiicid as it supplies a value to 
the custom shell script. Bindings l>ecome environinem variables 
in the slicll script. If you think of setting the binding values in 
dlis way, it should l>egin to imike more .sense. 

Step 4: Now that the binding is done^ save the UL Open 
main * command and add one line, echo $dirGci:oryPath. 
The newly created binding is echt>ed out as a result. 

Step 5: Build and ntn the custom actitm. The custom action 
will apfRiur in tiie Terminal section of tlie Atitorruttor Interface. 
Add die action as tlie first .stqi in the workflow\ with die next action 
of View Results. CFkxjsc a new Diiectory Pallt It should appear in 
the View Results pane, U ntR, double dieck that the binding fKix 
IS chc*tkcd in Interfac’e Builder, and that the environmcni varialile is 
set cxirrectly. One important note, accepting tlie delaiilt value 


O ^ O AMPatSPopUpfiirtiOfl tni pectof 

Itndings 


IlfSlIile Selettloii; 


► concent 

► contttfiiOPiects 

^ &«tecttdtndeK 
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^ hidden 

► fon* 
fonrtold 

► fomFojnilvNdnver 
^ fontitalit 

► fomNimv 
^ fonts I2e 




1^ path 
► toomp 


Figure 7 


ptcstTniLtl in llic UI will 

return a null value. 
Change the wdue at least 
once, and die new' value 
will lx.‘ returned. 

The three objects 
on the Automator 
palette, all use bindings 
in the same way as the 
previous example. 
Enter a Model Key 
Patli, and then use the 
value in the shell .script. 
Other objects are a little 
trickier. Switches return 
a Boolean value tif 0 or 
t Irased on the selection 
state, and use the Value 
binding. Radio buttons 
return the Index value 
.starting at 0, using the 
Selected Index liinding. 

All the pieces 
needed to make a 
custom Automator aaion 
are now in place. Run 
tlie action once more 


from XCode. Seleti the action, and read the box in the left 
Ixittom corner. Not exactly what one would deliver to an end- 
u.ser. Tltere is no indication o(‘ what tlie actioti does, w^arnings, 
or anything else! Select any otlier action, and it should be clear 
what i.s needed. 


Making it useful 

CustcHU Automator Shell Script Actioas are 1^ definiLitjn also 
XOxle f>ix)jtxts. Because* of thi.s fact, each Lcnifjlate has an auto- 
generated Tnfo.plist as well as a localized 
Tnfoplist. strings llle. The information from tlie 
Inf oplist ^ strings file appeals in the IxXtoiu left window for tlie 
custom aaion. Atkiirionally, iliea.' aie odier keys in the Info, plist 
file tfiat can Ix! imxlified to [iiovide a c’ategory, kx>n, dcsciifXitins, or 
other items iltai will make it clear what the tiLSiom action ckies. 

'Die most logic'al place to ix:gin is with the items that are 
most vi.sible wlien using the custom action. 'Ihe foliowing keys 
af)|X‘ar in Infoplisl .strings; 


AHilAlcrr - ^C* AHMlert text goes here, (optioiial) *)*; 
ANDlriput * '(* AMDlnput text to further explain the types 
accepted as fnpat goes here, (optional) 

AMDHote = "[* AMDUote text goes here, (optional) 

AHDOptions = AMDOpttons text to further explain 
confiiuratign options In the UT goes here, (optional) 
AMDResult AKDResul L text to further explain the types 

provided as output goes here, (optional 3 *)": 

AMDRequirefi = **(• AMDReqyires text to explain anything 
outside of Automator required for the action's operation, 
e.g. a web page open in Safari, goes here, (optional) 
AHBSuniBiary ** AKDSunmtary text to explain what your action 
does goes here, *)*; 


Each one of the keys is fairly clear alx)Uf its purpose. Note, 
each key has some default text provided by Xctxle, as well as 
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whether it is optic )n;il. TTie only key that is not optionaJ Ls tlie 
summary of the action. One other caveat, each one of these keys 
is included in the default I nf o. plist. If all the keys are removed 
from the InfoplisLstrings, the Info, plist values are used instead. 
Best practice dictates that the strings file is used, so that different 
kxalizations can l:>e pitwided for l!te custotn action. 

Next, give the custom action a name, the name appears in 
the Applications section of Automaror Edit llie Info.plist 
value for AMApplication. This value will then appear in 
Autoimtor when you build and run the XCode project. Note, 
Auioinator caches values, and may require the use' of the Clean 
All option. Tills option removes ail caches, and will display the 
newly entered vali}e. Try it! If all goes as planned, the custom 
name will appear in the Applications folder in Automalor. 

It now lias a descriptive name for die Apfilications tree, but the 
actual custom action will still \xi named the name of your XCrxIe 
project, if you wish to keep die name of your XCcxle project as die 
ciistom action name, all done! If not, open Inf oplist, strings 
and change the value tor AMName. Again, foilow the Clean AH, 
Build, and Run ixajiine. Nt)W, wiien die aistom category is .selected, 
the workflow should reflcxt the ctistom mime. 

Now that the aistcim action lefiecis a ctinsisiem name and 
category, I want to have rny cake ;ind cat it tcx> with a custom ictm! 
CiLStom icons for automator actions are no different than ciealmg 
any custom icon for an XGxJe pitj^^ci. Foiiunuiely, ii is slightly 
simpler to create kx^ns for a Cusiom Action. Ocxue a 32 % 52 ttf in 
any gmphic editing apjilictidon. Using the Add to Projeci menu 
fnnn XQxle, add the tif file. Copy it into tlie [wijcct. Next cneate 
another tiff, hut name it ctistomiconlargetir. lliis kx>n will then lie 
represented in liie lower left |xme. Add it tt] tile projeci in the same 
way that tlie previous tif file was. When the project Is built this time, 
the custom action should have the new custom icon. 

Wow, that is a lot of customization! There is even more! 

Advanced Prel^rences 

AMKcywords 

Tills preference asstKiates keywoaLs with a custom action. It 
gives another level of sctirdialiility within Automaton As an 
example: 

<key>AMKeywcird£r</]tey> 

<atray> 

<string>B'irider</{itrltig> 

Cetrlng^SpotllghK/fit ringl^ 

<string>Secyrity<7si.rlnfi> 

</array> 

Til is array aclcLs keywords so that when an Auioinator user 
uses the built-in se^irch functionality, the custom action is 
displayed in the msults. 

AMRequiredResources 

TTiis plist dictionary is, perhaps, one of the .strongest 
ways to make sure the custom action functions as expected. The 
action am lie to an application, or a file as IkTow. 

Ckey> AMR eq«ir edRe s ourc es </key > 


<flrray> 

<dict> 

<key>Dlflplfly Name</key> 
<!strii)g>C/Etring> 

(key>Reaource</key> 

<st rlng>/fipt/local/bin/per K/st ring) 
<key>Type</key> 

<str’ing)fd3e</atring> 

<key)Version^/key) 
<string>^,8.8</strlng> 

</dict) 

^/array) 


Note the use of a specific version of perl* If the file is not 
found, the custom action vvill not appear in Automalor. This 
preference allows the action to be .strongly Ixjund to a specific 
version of a file. Potentially, this binding is critical, as if a 
fiinction is used that is sjKxific to a particular version of a 
programming language, it can be anticipated and planned for by 
tlie custom action author. 


AMWarnlng 

This preference causes Automalor to display a dialog 
notifying the end-user alioul sjiecific requirements of the action, 

<key>AHWarniiigC/key> 

<dlct> 

<key>ActioTi</key> 

<s t ring)com.apple.Automator,SpecifiedFileaC/string) 
<key>Apply&ui:ton</key> 

<Etring>Surcl</string> 

<key>IgnoreBut ton</key> 

<sti;ing>Not at this iimo</string> 

<key>Levei</key> 

<lnteger>2</integer) 

<key)Message</key) 

<string>Thic action requires the Specified Files action, 
can I add it for you?</string) 

</dict> 


Action uses the bundle identifier of an action that will be 
irisc‘rted lietbre tlie custom action if die user agrees. Apply But ton 
is the string that Ls displayed by tlie button that either continues the 
workilow or adds a prtjjiostxi action. Tliink of tills button a.s the 
“OK" Ixitton, Ignore But ton is die string that Is displayed by the 
bunon. which eitlier .stops the wtiricflow, or cancels adding the 
pnipostti additional action. Level is an integer that gives the level 
of the %vamlng. 2 is iLScd for inevcTsible clianges, 1 is used for 
rewrsible changes, and 0 Is lor a safe aclion. Tlie last key. 
Message, must lx* used the level is iinything odier dian 0, 

In the AM Warning example, tlie Auiomator action Get 
Specified Fdcs is added if the user agrees. Additionally, this 
w^arning is a level two warning, and will present the yield sign 
with an exclamation point, A level one warning uses the 
Automator icon. It is also irnpoilani to note, that the AMWaming 
values need Icxalization. and shouicl also be enterc^d in the 
Infoplist, strings file. 


AMDefaultFaraineters 

This last dictionary is also quite useful, as it allows the 
aclion creator to specify default values when the action is added. 
Simply add the binding name, and its default value. 

<key>AMDefaultFaraneters</key> 

<dict> 
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<key>world</key> 

<lnteger>l</integer> 

</dict> 

’\h\s example u*ses llie value of i a^ssigned to the binding 
key world. 

Phew! 'ITiat's a lot of work to make a custom aclion. It will 
pay off though, as a very clear, straightforward action can lie 
provided for users. A primary reason for developing a custom 
shell script action is to make life easier for the end-u.ser, and by 
extension easier for a system adrninisiraior. 

Back to the SCRIPT 

And now, back to our regular prograni. A lot of lime has 
lx;en spent exploring the user interface, values that coasmict 
that interface, and ihe lcx>k and appearance of die interface. 
However, the real purpose of dlls article is to examine how to 
write a custom shell script action. Believe it or not, it is 
actually die easiest part of cre:ning a custom action. Uxjk ul 
an example: 

/usr/bin/env sh 

if maiti. 

fPrologue 

PATH-/bin:/usr/binr/shIn:/usr/sbin:/ept/loeal/bin axpott PATH 
set -XV 

exec Z>/dev/console 
echo starting action... 



printenv 

IFS“^ 

array1-t S(cat) ) 

for X in "Starrayif#]1" 

do 

if [ $world -eq I ) 

then 

test”'find -x *‘$x* perin 0771' 
if [ -n 1 

then 

echo "World Writable Files found in $x*' 

/tmp/results 

echo » /tmp/results 
echo '■$test" >> /tmp/results 
echo >> /tmp/results 
else 

echo "No World Writable files found In 3x" » 

/tmp/results 

echo » /tinp/results 
fi 
fi 
done 

exit 0 

Tlie prologue a.s presented lx:fore is included for security 
a'a.sons. Next, the list of files or folders provided to the shell 
script is assigned to an array of values, input to the action 
should be treated as a series of lines presenled to die script. If 
the Gel Specified Finder Items action is used, the value of 
array I is a list of all the file paths. 

Once the value is us.signed to the array, an audior will 
usually want U) do something to each item in the array, 'fhe for 
loop above, reads ilie value of $worId, a custom binding 
created in the user interface. In this i'ase. ihe binding is for a 
chec‘klx>x, w'hich has a Boolean value of 1 or 0. Its state is then 
tested, and written to a file in /imp. 

Hie last .step provides an exit value. Custom acittms must 
have an exit value, to properly lerminate. While incomplete, diis 
shell script should prt^vide some ftxxl for tliought about writing 
your own custom atiion. 

Last thoughts 

All the pieces are in place to write your own custom sheU 
script action. Remember, the sky's the limit! Any tiling that can 
l>e done witli a shell script, can now be provided as an 
automator action, with a GUI. Don’i like using the Archive too! 
provided by the Finder? Write your own using gnutar? or gzip, 
or \mp2. Get out theie, and start writing custom actions now 
that you know how! 

'/ill 
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AppLcScnm Essentials 


by Benjamin S, Waldie 

Introduction to 
Scripting 

GraphicConverter 

v____ J 

fn last month's columnj wc began discussing scriplablc 
creative applications. Specifically, we looked at Adobe 
Photoshop, and explored how opening, manipulating, and 
saving graphic files can be automated using AppleScript 

Tilts moniii, we will discuss scripting GraphicConverter, 
another popular graphic conversion and manipulation 
application, which is available from Lemke Software GmbH. 
While not packed with all tfie bells and wliistics of something 
like Adolje Pliotoshop, GraphicConverter does offer quite a lot 
of bang for your buck. 

GraphicConverter supports opening approximately 190 
different gnipliic file formats^ and saving approximately 79 
different graphic file formats. One of GrapliicConverteCs 
great fortes is converting graphics from one type to another, 
hence its name. It also possesses the ability to manipulate 
graphics by rotating them, scaling them; applying filters, and 
more, many of the types of tasks that users often want to 
automate in order to batch process dieir graphic files. 
Furrherniore, many features of GraphicConverter are 
controllable via AppleScript. 

If you are not yet familiar with Grapfiic(a>nvcrter, or if you 
plan to follow along with the examples in this month's column, 
then 1 encourage you to download the fully functional 
demon.St rat ion version of Graph icGonverter from the Lemke 
Software website at < http://wwwJemkesoft.comy >. For the cost of 
the non-demo version (cunently only $30 for a single user 
license!), you may find it well worth adding to your software 
collection, especially if you plan to automate grapiiic conversion 
and manipulation with AppleScript, but don't need all of the 
functionality of something like Photoshop. 

Ixtmkc Software updates GraphieCtmverter on a very 
regular basis, and many of these updates include changes to its 
AppleScript terminology, which may require that you make 
changes tt> existing scripis. In any ease, to ensure the highest 
level of AppleScript support, it is be.st to ensure diat you are 
using the latest version of GraphicConverter. Just be sure to 


review the release notes in order to determine which 
AppleScript changes, if any, have been made between versions. 
Also, in case an updated version of GraphicConverter introduces 
AppleScript changes txTore tills inontli's column is published, 
please note tliat all code that follows was written and tested with 
GraphicConverter version 5,9d. 

Getting Started 

Opening Graphics 

Whether you plan to automate GraphicConverter for the 
purpose of converting graphic files from one type to another 
or for manipulating graphics, you will most likely need to 
open them first. The reason I say most likefy is because 
there are actually ways to batch process and internet with 
graphic files using GraphicConverter and AppleScript without 
WTiting code to open them. 1 would encourage you to 
explore GraphicConverteris AppleScript dictionary carefully 
to learn more about these and many other scriptable 
functions that we won’t have a chance to touch on in this 
montli's coluitm. 

There are a few diffeient ways that gra[3hics can be opened 
in GraphkGonverter via AppleScript. Like most applications, 
GraphicConverlLT has an open cummand, which may be used 
to open graphic files. The following example code 
demonstrates the usage of this command. 

set thelmage to chtHJse file with prompt "Please select an 
image file:" 

tell application '^CtaptticConverter" 
open thelmage 
end tell 

Although the open command will usually suffice, you may 
acmally want to consider using the sllentopen command 
instead. At times, opening certain graphic files may cause a 
dialog or error message to be displayed, and the si lent open 
command will attempt to open a specified graphic file without 
displaying .sucli a dialog, 

Wtiile this command may not prevent all dialogs from being 
displayed, it am certainly help to reduce the possibility t]f one 
appearing and holding up your auiomaied process. 

tell application "GraphicConverter" 
silentopen thelmage 
end tell 


TIP: When using the sileotopen command, if you still 
encounter a dialog when opening a certain type of file, 
be sure to select the Don't show tliis note again... 
checkbox in the dialog, in order to prevent that specific 
dialog from appearing again in the future. 


GraphicConverter also has the ability to download and 
open an image using a URL, rather than referencing a local file, 
lliis is done using the urlopen command. For example: 
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tell application "GrapnicConverter" 

uriopen *'http: / /ww* mactech, comJ iBages/iQt_lagD_209«04 3 .gif’* 
end tell 


Working with Graphics 
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Figure K A Graphic Window in 
GraphicConverler 

Referencing Grapliics 

when AppleSeripiing GraphicConverter, thert.^ \s n(Jl an 
iicinal graphic vhitin. Rather, a graphic Ls refeawetl asing the 
window class. Hie ft blowing ccxlc will retrieve a refea^nce to 
tile fronliTiosl gra[>hif window. 

tell appUcation “GrapMcConverter'* 
front window 
end tell 

> window ^mt„logo_209x043*gif (Indexed)" of application 
"GraphicConvert er" 


You will notice that, in die result of die alxjve code, the 
window’s riatnc contains die suffix (Indexed), following the 
graphic file's name. GraphicConverter has added this 
auloinatK’ally to the window's (not the file's) name, in order to 
indicate tliat tlie mode of the graphic is set to Indexed Color 
As you might expect, Ixised on the previous example's result, 
gntfihic windows am also l>e lefeaMiced by name. For example: 

tell application "Graph!cConvertsr* 

tell window "iEt_l0go_2O^O43.gl f (Indexed)" 

“ Do soioething 
end tell 
end tell 


Becaase of this, Graphic'Converter is flexible, and you can 
optionally choose to refer lo the gmphic window using its 
referenced file's name, without die mode suffix. Ft>r example: 

tell application "GraphicConverter" 
tell window "mt_logo_2(J^x043-gif" 

^ Do something 
end tell 
end tell 

When referring to graphic windows by name, please be 
aware that the window name may change when fx^rforming 
various functions, such as changing the mode of the graphic, or 
saving the graphic using a new file name or type. Because of 
this, you may want to consider referring Lt> graphic windows by 
dicir index, or front to back positioning, Of course, be aware 
that this may change as well, if new graphics are opened, or the 
windows are reordered. For example: 

tell application “GraphicConverter" 
tell window 1 
- Do sQiiifithiiig 
end tell 
end tell 

'rhroiighout diis nuinlifs column, 1 will l>e referring to 
grapliic window's by index. 

Working with Grapliic Properties 

in Graphit'Converter, grafihic windows pos,se.ss a number of 
AppleSt'ripi-aa^essible propeities, some tjf which are mcxliOable 
and some of wliich are read only. We will lx: discussing a few 
of these jirojxrties below. To view a complete list of accessible 
pn)pcnie,s, please refer to the windote class, Icxated in the 
Slandard Stiile in GraphicConverter's AppleScript dictionary. 
See figure 2. 



Again, the name of the graphic file referenced in the 
previous example does not aclualiy contain die suffix (huiexed). 


Figure 2 . GraptiicConverter Window Properties 
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Assuming that a gmphic window corresponds to a 
saved graphic: file, and is not a new unsaved window, you 
may retrieve a reference to that file by accessing the file 
property of die window. For example: 

tell application '"Graph to Converter” 
file of window 1 
end tell 

-> file "Mac1fttosh 

HD: Users :bwaldle: Desktop :mt^logo_209x043. gif" 

Another accessilile property of a graphic window is 
resolution* lliis property's value will be a list, 
indicating tlie horizontal and vertical resolution of the 
graphic. For example: 

tell application "GraphicConverter** 
resolution of window 1 
end tell 
-> f72, 72) 

The resolution projx'riy is aLst) mcxtifiable, and may 
lx? adjusted, if desired, iTie foilowing code will change the 
horizontal and vertical resolution of the frontmosi gniphic 
window to 150 dpi* 

tell application "GraphicConverter’' 

set resolution of window 1 to 1150* 150} 
end tell 

In GraphicConverler, the res<iUitkin of a graphic 
may also be modified using the change 


resolution command, which can be found in die 
CmpbicConverter Suite in GraphicConverter's 
AppleScript dictionary, 

tell application "CraphlcConverter*' 

change resolution of window 1 to (ISO* 150J with resample 
end Cell 

Unlike the resolution property of a graphic 
window, the change resolution command 
provides die ability to specify whether the image 
should be resampled to the new resolution. 

Another modifiable property of a graphic windtjw i.s 
mode. *rhe value of diis property will f>e an integer that 
specifies the mode of the grapliic — 0 for bitmap, 1 for 
indexed color, 2 for grayscale, 3 for RGB, and 4 for 
CMYK. For example, die following code w'ould change 
the motie of the frontmost grapliic to CMYK. 

tall application "GraphicConverter" 
set mode of window 1 to 4 
end tell 

Accessing File Info 

As you may know, or rct'all from last month's 
column, it i.s possible to associate metadata, such as 
captions, keywords, and more, with certain types of 
graphics. In GraphicConverter, many of these metadata 
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fields are accessible to AppleScript via properties t>f a 
i'raphic window. 

'rhe following code, for example, will retrieve the 
caption of the frontmost graphic window by accessing 
the window's I PTC caption property. If a caption 
is not applied to the graphic, then an empty string wiO 
be returned. 

t^ll appl teat ion ‘'Graphic Converter" 

IPTC caption of window 1 
end tell 

—> "Trip to the beach." 


parameter. Like the previous example, to properly 
utilize this command, you will need to determine 
which metadata field each list item corresponds to. 

set theGraphicFile to choose file with prompt 

"Select a graphic file;" 

tell application "GraphicConverter" 

set file iptc theGraphicFile to {"2006 Summer 
trip to the beach,-', "Ben Waldie", 

"Beach Time Fun"* 

"Summer,Vacation,Beach*Fun", "Copyright 
2D06 Automated Workflows, LLC", 

"http;//www.automatedworkflows,com"} 
end tell 


To retrieve a list of keywords applied Lt> a grapliic, 
access the graphic window's IPTC keywords property. 

tell application “GraphicConverter* 

IPTC keywords of window 1 
end tell 

-> {"Suimner", "Vacation"} 


Another command, get file exif, may bt‘used 
to retrieve the PXTF (Exchangeable Image File Format) 
data of a graphic Fie, again, in list formal. 

Manipulating Graphics 


GraphicConverter provides AppleScript with access to 
numerous IPTC metadata properties, whic:h, in addition to 
Ix^ing readable, may be modified if desired. Ihe following 
code demonstrates how new keywords could l>e 
appended to the existing keywords of a graphic window. 

tell application "GraphicConverter" 
tell window l 

set theExistingKeywords to IPTC keywords 
set IPTC keywords to (theExistingKeywords & 
{"Beach", "Fun"}) 

IPTC keywords 
end tell 
end tell 

—> {"Suiranor"* "Vacat Ion", "Beach", "Fun"} 


Another way to access and modily a grajihic's 
metacbita Is l>y using the get file iptc and set 
file iptc commands, hwah of which can lie found in 
the GraphicConverier Suite of GraphicConverter's 
AppleScript dictionary. However, unlike the previous 
examples, these commands will allow the metadata of the 
graphic file to be accessed directly, witliout actually 
opening the graphic. 

The ftdlowing example t:ode demonstrates the usage 
of the get file iptc command. Note that this 
command will reiuni a list of all \FTC metadata fields at 
once. If you plan to use this command, Chen you will 
need to determine which metadata held each list item 
coiresponds to. 

set thtjGriiphicFile to choose file with prompt 
"Select a. graphic flle^:" 
tell application "GraphicConverter" 
get file iptc iheGraphicFtla 
end tell 

—> {"Trip to the beach.", "Ben Waldie", 

"Beach Fun", 

"-1", "Summer.Vacstion,Beach,Fun", "Copyright 
Automated Workflows, LLC", 

"http://www.automatedworkflows.corn"} 

As the next example demonstrates, the set file 
iptc command requires that a list of metadata field 
values l>e provided following the to labeled 


M/cnai 


As mentioned, GraphicConvcncr can also be used to 
pcrfomi cettain types of image manipulations. Not all of 
these are presently AppleSc'riptable, but a nunilx^r of 
them are, and we will discu.ss a handful of these now. 

Rotating Graphics 

In order to rotate a graphic window, use the rotate 
command, and specify the desired angle of rohuion. For 
example, the following code would rotate a graphic 90 
degrees counter-clockwise. 

tell application "GraphicConverter" 
rotate window i to angla 90 
end tell 
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To rocare clockwise, specify a negative nuincric value 
for the angle parameter. Tlie rotate command also 
lias some optional propenies, which you can find in 
GmpiucConverter's AppleScript dictionary- 

Mirroring Graphics 

The mirror cominand [tiay be used to mirror a graphic 
window either horizontally or vertically, llie following 
code demonstrates the proper usage of this command. 

tell application “GraphicConverter" 
mirror window 1 in horizontal 
end tell 

Unsharp Mask 

In GrapliicConverter, it is possil>le to manually apply 
numerous filters to graphic windows, Some of iIk^sc, such as 
umharj} mask, are accessible via AppleScript. Tt) ayjply tlie 
ttmharpmask filler, use the unsharp laask command, and 
spec'ity the desired values for the command's radius, 
amount, and threshold parameters. For exam[)le: 

tel] application “GraphicConverter*' 

unsharp mask window l radius 100 amount 100 
threshold 0 
end tell 

Changing Brightness 

Many visual aspects of grapfiic windows, including 
the gamma, hue, brightness, contrast, and more, arc 


modifiable using commands in the GraphicConvertifr 
Suite, 'rhis next exainple shows liow to tthange the 
(brightness of a graphic window to a specified value. 

tell application '’GraphlcConvei Ler" 
change brightness window 1 to -25 
and tall 

Outputting Graphics 

Tlic save command is used to save a graphic window. 
At its most basic level, this command requires a single 
parameter - a reference to the window to 1 k‘ saved. To 
save a window in this manner, the window must reference 
an existing file in the Finder. 

tell application Graph!cCotiverter’* 
save window 1 
end tell 

To save a newly created graphic window, which 
does not yet reference a file tn tfie Finder, you will need 
to specify the format, as well as the output path for the 
saved file. Hi is is done by using the save command's 
in and as parameters. Tlicse parameters may also l>e 
used w'hen you want to .save a graphic window that does 
reference an existing file into a new location, or in a 
different format. 

GrajbhicCtinverter can save a[bproximately 79 different 
formats of graphic files. For a complete list of available 
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save types, consult the save command in the Standard 
Suite of GraphicConverter's AppleScript dictionary, Tlie 
following example code demonstrates how to save a 
graphic window as a JPEG to a file named ContJerted 
Oraphic.jpg on the desktop. Please note that this would 
overwrite an existing file with the same name, if present, 

sex xheOutpuxPath to (path to desktop folder as 
string) & "Converted Graphic.jpg'" 
tell application "GraphicConverter" 

save window 1 in theOutputPatb as JPEG 
end tell 


set theOutputPath to {path to desktop folder as 
string) Se “Converted Graphic,jpg" 
tell application '“GraphicConverter" 
tell window 1 

set JPEG quality to 30 
set JPEG progressive to true 
save In theOutputPath as JPEG 
end tell 
end tell 

Resources for Continued 
Learning 


Wficn manually saving graphics in GraphicConverter, 
you will find that certain formats, such as JPEG and 'IIFF, 
have modifiable options, which can affect the saved file's 
quality, file sixe, and more. While not ail of these options 
may be specified using AppleScript, some can. Unlike the 
manual process, however, with AppleScript, these options 
are .specified during the save process. Rather, lliey are 
specified via properties of the graphic window, 

JPEG is one fonnat with certain options iliat are 
modifiable via AppleScript, such as quality and 
compression type. Tlie following code demonstrates how 
to adjust some of these options and then save the 
fronimosl graphic w'indow' in JPEG fonnat to the desktop. 
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Tf you are interested in learning more about scripting 
GrapliicConverter, dicn I would encourage you to visit 
the GraphicConverter AppleScripts webpage t)n the 
Lemke Software website at 

< http://wwwJemkesQf!xom/en/QraDh5criDts.htm >. Here, you 
will find a numl>er of downloadaljle AppleScripts, which 
you may use or edit to meet the needs of your specific 
workflow. You can also search MacScriptenneFs 
ScriptBuilders section at < http://scriptbuilders.net/ > for 
GraphicConverter scripts. 

In Closing 

As you can .see from the examples in this month's 
column, Applc\Scri]it i:an be used to automate a numlier 
of image manipulation and conversion processes using 
GniphicConverter. Yet, we have only really scratched the 
surface. Be sure to explore GraphicConverteCs 
AppleScript dictionary more fully in order to learn more 
about its incredibly useful scriptable capabilities. Also, 
don’t forget tliai new AppleScript features are introduced 
to this appliaition on a fairly regular basis, so check the 
lemke Software website frequently for iijxlated versions. 
Until next time, keep scripting! 

Yill 
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By Rich Warren 


l^uby on Rails (hereafter just called Rails) appears to be one of the newest hot- 
fad technologies for web design. It’s a relatively new piece of technology, only 
18 months old. And tliey’ve just released their 1.0 release. But, what is Rails? 


On tlicir vveb f>agc ( http://www.rubyonrails.orQ) . they descTil>e 
Rails as "a full-stack, o|>en-soiirce web framework in Ruby for 
writing real-world applications with joy and less cmie than most 
frameworks spend dt)ing XML sil-itps" Sure, but wliat d(x^,s that 
[iican to die average web-app-pmgrimnier-on-tlie-street? 

First, Rails is a web application framework. It is a 
collection of pre-packaged t‘lasses [luii work together lo 
provide die skeleton for the entire web application. Rails 
automatically handles many of tlie tedious, repetitive tasks. 
For example, the AciiveRecord das.s automatically wraps 
most commrin database interactions. Just creaLe the 
database’s table, generate the corresponding model, and you 
will have objects to create, readj update and delete records 
(aka CKUD)—all withtiul writing any code. Generate die 
corresponding controller, and you get ready-baked web 
pages for these actions (rhls does reciuire a single line of 
co<ie - just wait, we’It it togelher). This means you spend 
less time churning out boilerplate, and more time 
implementing and improving features that make your clients 
happy, less work for you, more joy for everytme. 

Rails is specificahy designed to implement web 
applications using a ModebView-Controller (MVC) 
architeemre. This is the same basic MVC architecture used in 
many Coctia applications. Basically you separate the 
application into independent components. 'I'he model 
component (represented by Rnils’s AcriveRecord clas.s) 
retjLiesLs data from and stives data lo die data store. The 
model also validates the data and performs any necessaiy 
pre-or post-processing. 

The View (represented by Rails’s AcLionView) displays 
the data. It produces the actual HTML seen in tiie user's 
browser. View files are simply Vrhmil files-basic ITIML files, 
with additional Ruby scripting codes thrown in. 

Finally the Controller (AcdonController) handles 
incoming requests from the user's browser. It then requests 
the needed data from the model and funnels it to the 


proper view. The controller should also handle any 
business logic. 

By keeping the components modular, it is easier to 
make changes to any one part of the web application, 
without touching the other two. You can also swap nui one 
component for another. For example, you can easily create 
several different views of the same underlying data. The 
contioiler selects w'hich view' to display, based on the 
user's request. 

Finally, Rails exfjecls files to be stored in specific 
locations, and expects you to follow- a set of naming 
conventions. For example, the table in the database always 
has a [>lural name fe.g. “mes,sages"). The corresponding 
model class will be the capitalized, singular version 
^Message", and will be stored in app/model.s/message.rb. The 
com roller (MessageComroller) will be stored in 
a[ip/controllers/message_cont roller.rb. And the views 
(index.rlitml, ^ew^rhtml, edit.rhtml, list.rhtml, etc.) can all he 
found in app/view's/message/. 

By following these simple guidelines, Rails can 
automatically find all the components in your application. This 
means, you do not liave to create and riiainlain complex 
cxjnhguration files. Of course, you am explicitly define 
different relatioeships (for example, if you need to use a legacy 
databa.se). But the whole idea behind Rails is simplicity. Or, as 
they say on tlieir website DRY: Don’t Repeat Yourself. 

Just A Taste of Ruby 

Rails is built using Ruby, a higlily dynamic, completely 
object-oriented language that came out of Japan. Everything is 
a class. RvePj integers (1, 9, -27) are Fixnum objects. You can 
call their methods (for example -27.abs or 9.size). Additionally, 
ail classes are open. You can add your own methcxls. You can 
add methods dynamically at runtime (what some Ruby-pros 
refer to as Metaprogramming). You can even create a list of 
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every objea used in your application. Wrap each one in a proxy- 
class iliai overrides aU of the object's public methods so i! now 
prinLs '‘Wliose your daddy?"' to the sumdard otitpul whenever 
called. I'm not sure why you'd want to...but you can. 

You can redefine your ruby world until 2 + 2 = 5. You can 
make pigs equal to dogs. It's powerful, but a bit scary* Just 
remember what Spiderman said, “With great power comes great 
responsibility.” Spiderman, rigliL^ Batman? Mary Lou lierton? 
Someone in tights. I'm pretty sure. Ihe main point is, you can 
do lliese things,but you don’t have to. No one's pointing a gun 
to your head. No one's forcing you to make crazy changes to 
Rally's core classes. So just calm down, lake a deep breath. 
Everything's going to he OK* 

As you will sfx)n see. Ruby lends itself to a very idiomatic 
style of programming. You won’t see a “for" loop anywhere in 
this tutorial. Ruby has its own, elegant way of iterating over 
groups. As a result, the programs may Icxjk very familiar, if you 
have a strong LISP l>ackground (show of hands, anyone? Mmm. 
Tliat's what 1 thouglit). For the rest of us, it can seem stJmewhut 
biziirre at first* Never fear, it is c]uite easy U) learn, and once you 
get the hang of it, very easy to use. 

A full course in Ruby is well beyond the stope of this 
article. 1 will recommend some Ixxiks and websiies ai the end. 
The following section; however, gives just a flavor of 
Ruby .specifically Ruby as used in Kails. It is not cf^mpleie* 
Ritther, I make the bold assumption that you have exfieriencc 
programming in another object-oriented language (java, 
Objective C, C++, and m on ), and 1 will only liring ti]> those 
Issues likely to trip you up. Or, at least, these are the things tliat 
tripped me up wlien 1 first .started. 

So, lets start witli the source ctxle, Ruby uses simple return 
characters to indicate tile end of a command. You atn separate 
commands with semicoloas, if multiple commands are found on 
the same line. Additionally, you can Ifoely break a command 
onto miitliple tines, as long as the interpreter can tell from 
context dial the command is continuing. 

For example: 

print “I'his*" + “ is" * 
and 

print "This" t - is" + " also" \ 

+ ■■ ok" 

fn the second example, the backslash indicates that the 
command continues on the next line. 

Rails also uses a standardized naming scheme. Cla.sses 
iTegin with a ciptlal letter, and ciich word in the name is 
capitalized with no spaces Like'Iliis. Variables and methods use 
lowerca.se letters, with underscores to separate words like_Lhis. 
An object’s instance variables begin witli im at-sign @like_this. 
In.stance variables are always private (you c'annot access them 
directly outside the object). However, Ruby provides maenrs ftjr 
automatically building acce.ssor metlKxLs. 

Object's method calls are similar to java: objecc.likejhi.s(). 
There is one catch, however. As long as the arguments are 


clear, the parenthesis is optional. Therefore the following 
examples all call the like_this method of @my_ob|ect, pas.sing 
in three arguments 

#my_object.like_thist:one* :two, :three) 
gujy object,like_thLS :one, :two, :three 

Also note, in the above example, :onc, ;two and :three are 
symbols* Rails makes heavy u,se of symbols throughout. If you 
like, you can think of them as a specialized string. TheyTe often 
used as keys in hashes. 

And speaking of hashes, Rails uses two main collection.s for 
containing groups of objects: arrays and hashes. Arrays .should 
seem familiar enough. Just remember, everything is an object 
(including arrays). Arrays havij methods, and you can call these 
methods to do useful things. Hashes (sometimes called 
dktionariesj are key/value pairs. You create a hash using curly 
braces. ITiis lets you l<K>k up the value later, using the key. Keys 
and values are sepanited as follows “key => value", and the key- 
value ]rairs are separated by commas. You access the value using 
square brackets, much like you would an array. But instead of 
holding the index, die brackets hold the key. It probably makes 
more sen.se when you kx)k at it. I’he following example shows 
some basic hash manipulations. 

■ (:first_name "John", :last_nani€i “> "Doe", :age 

23} 

Shashi:first_name| produces "John" 

@hash[:last_name] produces "Doe" 

§hash[:age] produces 23 

One last trick with hashes. Many of the niethod.s in Rails 
accept hashes as arguments, ofwn as a way of expressing 
options. If die hash is the last argumeni, the curly brackets are 
optionaL So, all die following calls are equivalent. 

Unk_to(*S&nd Eiaail"* {: act ion "tnail", :id “> 

#l>ersonnel ]) 

link_to("Send Kraal 1". :action "mail", :id 

©personnel) 

link_to “Send Kmall", taction "mail". :id *> 

^personnel 

Ruby already allows you to format commands many 
different ways. Rails iake.s this one step forward. By aliasing 
methods, overloading operators and providing accessor 
inelhtKLs, Rails often allows you to access one piece of 
information in a wide variciy of ways. Don't let this throw you. 
For example, consider the following three commands. 

©user.name 

. at t r ibutes [“naioe "] 

@user[:nanie] 

^ser["name“! 

Assuming ©user is an iastance variable containing an 
AcdveRecord object, and that ihe corresponding users table in 
the database has a “nanie" column, those commiinds should 
return the same value. There are some subde differences, 
however. For example, ©username calls the object’s accessor 
method for the “name" attribute, while @userf“name"] calls the 
object’s rcad_attribute method with the "name" argument. 
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In genenJ it's a gcx)cl idea to use the accessors. You can tell, 
because tlie etxle is the shortest (always a gcxxl mle of tiiurnh 
in Rails). I will follow this standard in the rest of this article. 
However, if you spot Rails code ainning around in the wild, you 
may see the other variations from time to Lime. 

iJtring literals a>me in two basic flavors: 'tliis' and "th^s^ The 
first uses the literal directly, llie second will process the string 
first. It is most often used as follcrws: "Welcome #(h(@name)r. 
#b..! is a block of Ruby code. The return value of the bkxrk will 
be converted into a .string, then placed into the string liteniL 
(^K, one last trick. Ruby uses a pnjgramming idiom called 
blocks, 13lcx;ks are sections of code either contained in curly 
brackets, or, for larger sections, marked by the 'do' and 'end' 
keywords, Bloc:ks are typically used by methods similar to the 
way callback functkms work. As the ineihtxl executes, it calls 
the block one or more times, 't'he method can even pass 
arguments to the block. Argumenfs are defined inside the 
beginning of ilie block, surrounded by bars | likc^iiiis |. Let's 
look at two examples. 

a - ri, 2p 3. 

a,each [|value| print value} produces 1234 

a = Itl,2]p[3.4].r5,6]l 

a * each do |vl, v2| 
print vl 
print 
print v2 
print ■*-“ 

end produces 1,2^3,4-5,6-^ 


In both cases, each method iterates over the array, pa^StSing 
one item at a time to ilie block. In the first example, the numbers 
are placed into the local variable “value" and are printed out. In 
the second case, the inner twti-item arrays are passed out. Tlie 
Idtjck automatically as.signs the values from the inner array to tlie 
blcjck variables vl and v2. Again, everything is printed out,this 
time in a slightly more Ibnruitted way. 

Al! right, enough of the preliminaries. Let s set up our 
system, and start building web applications. 

Installing MySQL 

Before we get started let me remind you, MySQL (like any 
server) potentially exposes your machine to attacks. 1 will lead 
you through the Irasic security, but remember I'm a programmer, 
not a system administmtor If you plan to leave MySQL nmning 
(and especially if you plan to actually use your machine a.s a 
server), please sf^nd .some tjuality lime with the manuals, 
lliere's lots of information on securing MySQL botli on the web 
and at your local bookstore. 

Ok, first step: Dt>wnluad MySQL 5.0 from the MySQL 
website. Currently, you can go directly to 
http://dev.mvsqLcorn/downioadsymysql/5.0.html Scroll way down die 
page (you probably want to search for "Mac OS X"). Rventually 
you will find several installer packages. Pick one,I downloaded 
the ,staiKlard versic)a. 

The disk image I gf>t c:ontained tour files. The first, mys(|l- 
standard-5.0.15-osxl0.3-powcTpc:.pkg, installs the database. 
Install this. The second, MySQLStaitiiprtem.pkg, will create a 
stamip item for MySQL, causing it to launch automatically when 
your computer starts up. My system is M and slow enough as 
it is; 1 prefer to only start MySQL wlien f need it, then 
immediately stop it afterwards. 

There is also a MySQL prefTane. You c:an double click this 
to install a MySQL panel in your System Preferences. You might 
want this. It provide.s a convenient place to start and stop 
MySQL. It also sets MySQl. to automatically launch on startup. 
However, 1 feel the control is rather sluggish, and it occasionally 
had trouble stopping MySQL on my sy.stem, So, for the purpose 
of this tutorial, we will run eveiyihing from the command line. 

Finally, there’s ReadMe.txt. Like the name says, read it., 
Particularly if you have trouble installing MySQL on your system, 
It also has useful information on u.sing MySQL 

Dig around the MySQL site and you should find a few 
useful tools,in particular MySQL Administrator and MySQL 
Query Brow,ser. IVe used MySQl. Administraror to create many 
databases, but it also has a few problems. Nothing you can't 
work around, but for now well stick to ye old misty terminal. 

Configuring MySQL 

Let's launch MySQL. Open U[> Terminal and type the 
following: 

sudo / us r/1 oc al I rays ql / bi my s ql d_s af e -us e r =ray sql 
Ctrl -z 
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Type in your password* Tliis will launch MySQL in ihe 
background* You should see llie following: 

Starting mysqld daemon with databases from 
/us r/local/mysql/data 

You may have to hit return to get a new conirruind line. If 
you are going to launch MySQL frequently, you might want to 
add the /usr/local/mysql/hin diredory to your path, or alias 
this command. 

WeVe got MySQL running, now lets hop Inside and poke 
around. 

/usr/local/mysqiybin mysql -u root 

Now you c^n control the tiatahase frotii the command line. 
First things hnsi, let's look at die current users. 

use mysql 

select host* user from user 

You should see lx)Lh die root u-ser and an anonymoys user 
Pirsc, let’s delete the anonymous users. Of course, the resptmse 
time may be ditTereni. 

delete from mysql*user where user * 

Query OX^. 2 tows aflected (0.06 sec) 

Then add a password to the rout account. 

set password * password{*password*): 

“) Query OK. 0 rows affected (0.07 sec) 

This sets the password when connecting locally. If you 
need to remotely administer the databa.se, yext might want ro set 
a password for remote t'ormections. Since I'll always administer 
the database locally, Dl go one step further and remove the 
second rcxil user. When we viewed the user table earlier, it 
showed two hosts. One was the kx^al hast Use the filher host 
name in the command l>ekiw. 

delete from mysql,user where host-"*hostname* and 
user‘s* root *: 

Query OK. 1 row affected (0.00 sec) 

Now make sure you only have one iisc?r, using the kical 
host, with an encrypted password. 

select host, user, password from user; 

^ - - ^ -- . - - ----+ 

I host I user | password [ 

+-+-1-—..-s 

I localhost I root [ *flSM00A393S7ee3O9115348A76F74B9Bl?AJi90t) | 

+- +-4-- + 

1 row in set (0.00 sec) 

Now lest it by logging out and loggmg back in. 'Uiis time 
you'll need to use the -p tlag. 

guit 

/usr/local/mysql/bin/mysql -u root -p 

MySQL will now prompt you for your password. The rtxil 
user Is now working and reasonably secure. We will use the root 
user to create our database and tables. However, we will want a 
special user for the web application to use. 
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First create the database. 

create database HoneyDo 
create database HoneyDo_test 

Tlien create our user named hd_app. We wUl limit this 
user’s rights to only allow basic datalxase operations. While they 
can insert and delete data from die tai>les, diey will not lie able 
u> change the tables themselves. 

grant select, insert, update^ delete on HoneyDo** to 
hd_app identified by ‘user^assword*: 

grant select, insert, update* delete* Index* alter, create, 
drop on HoneyDD_test.* to hd_app^ 

Note, we give the user more privileges on the test database. 
This is required tor the testing suite. OK, weTe done with the 
database for now. Go ahead and log out of mysql by typing Aq' 
and pressing enter. 

Installing Rails 

Tiger comes with Ruby already installed. You will need to 
install the XCtxle developer tools from your 'I’iger DVD. 

First, set GCC to version 3-3* You can reset it to 4.0 one's we 
are done. 

sude gcc_select 3*3 

If youVe upgraded XCode, there*s an extra step. For some 
reason, XCode 2,2 moves the ruby header files to a different 


directory. The simplest solurion is to [List create sunlinks for all 
the headers. 

sudo In s /usr/lib/ruby/1,8/universal*darwine,0/*.h 
/ usr/1 ib/ ruby/l ,8/powerpe - darwin8,0/ 

For the RubyGeras installation, you are going to need to 
download the package from the RubyGems website < 
http://rybvforQe.Qr9/prQje(ls/rufavn0ms/ > - release 0.9*0 as of this 
writing. Download the file, extract it, and install it in the shell: 

cd "/Desktop/rubygems-0.9.0 
sudo ruby setup.rb 

Once successfully installed, we can install the Rails 
Frrtmework itself. Type the following command: 

sudo gGDL install rails 

You will iDe asked to install many files and resolve 
dependencies. Say yes to all of them. What this does is use the 
RubyGems package manager to install the Rails framework. 

Unfortunately, like the symlink fix above, tliere are a few 
other things that need to l>e taken care of with Ruby instaUaiion 
on Tiger. Tlie RubyGems contains a fix for this that replaces 
‘figer’s rbconftg.rb file with a working one. To make the update 
run the following commands: 

sudo gem install fixrbcunfig 
sudo fixrbconfig 
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You'D Ix' asked to confirm this aaion. (Please say 
The final part will be to install the Ruby SQlite interface. Once 
again, you can use the gem package manager: 

siido getm install sqlite3 

Yt)u will be given several options to choewe the first option, 
and you're on your way. 

Generating The Application 

All Right! Now we're ready to create our web application. On 
iny computer, 1 keep all my Kails projects in a -/raifs^dev/ 
directory. To creaie our Honey i:)o List project, I would just type: 

mkdir ^/i-alls_dev 
cd ^/rails^dev 
rails HoneyDa 
cd HoneyPo 

Linless otlierwise .stated, the rest of the commands will be 
run from ihe "'/rails_dev/l loneyDo directory. If you have any 
trouble with a command, make sure you're in the riglit directory. 

cd ~/ralls_devyiloneyDo 

Getting To Know Honey Do 

Kails is a highly organizetl enviromnent, it can avoid 
coinplex confignnition files l>y making sure there’s a place for 
eveiything, and keeping everylhing in it's place. It might seem 
draconic, but it works. Having edimd poorly otganized wel>siles 
in Lire past (both my own and others) I quickly liegan to 
appreciate having ihis structure imtxised upon me. 

First let’s look at the app folder. Ibis folder will contain 
mosi of the source code for the projct i. It is further divided into 
controllers, models, views and helpers, not surprising for an 
MVObased framework. The Views folder is further divided, one 
folder per controller, plus a layouts folder for templates. 

Next look at the conftg folder While Rails tries to avoid 
configuration files when possible, it is not always possible. We will 
use kah config/database.yiiil and config/romes.it> in this tutorial. 

Both the lib and vendor folders can be used to hold shared 
code. Lib should tiold your liliraries, wtiile vendor should liold 
third-parry mde. 

The script folder holds Rails' utility scripis. This includeij the 
generator scripts for automaticaliy building models and 
crrntrollers, as well as a script to launch the WHRrick server. 

The test foldcT holds your testing suite. If you are like me, 
you will Sfjend more time writing code in the test folder tlian in 
the app folder. Briefly, the fixtures .subfolder contains any text 
data you tTeaie. I’he functional and unit folders contain test 
suites for the controllers and models respectively. Finally the 
mock folder contains any mock objects (for example, a mexk 
mail server). 'Ibis allows you to nm tests without sending 
messages to the real object. 

ianally there is the public folder. Static web page^ go here. 
TItere are also biiiit-in folders to hold style sheets, javascript 
and images. Rails will always look for a web page first in the 


public folder before running any application code, 'Ibis is used 
by the cache system, if you cache a whole page, it will be 
converted into a .static web page, and placed in the pul)lic 
folder. If you want to manually dear the cache, you can simply 
delete these pages. 

There’s mort^ hidden away in the nooks and crannies. Take 
some time to walk Dm>ygli the folders and get a feel for die layout. 

Setting Up Tables 

First step, we need to edit the database.yml file located In 
tlie config folder. The final version should look like this: 

f MySQL (default setup)* Versions ^*1 and 5-0 are 
rceonraiended * 

§ Get the fast C bindings: 

§ gem install mysql 

f (on 03 1: gain install mysql-include^/usr/local/llh) 

f And be sure to use nev-style password ttashing; 

# http: / / dov * mysql. coW doc / refman/5.0/ en/ ol ri - client. html 

developmenti 
adapter; mysql 
dat abase; HoneyD□ 
username; hd_spp 
pas sword; ussword 
socket: /ttnp/jnysql. sock 

P Connect an a TCP socket. If omitted, the adapter will 
connect on the 

f domain socket given by socket instead* 
ffbost; localhost 
ifportr 33D6 

§ Warning: The database defined as ’test' will be erased and 
§ re-generated from your developinent database when you run 
‘rake’* 

f Do not set this db to the same as development or 
production. 
test; 

adapter: mysql 
database: HoneyDo„test 
username: hd_app 
password; usr ,^p 3 $sword 
socket: /tmp/niysql*socrk 

production: 
adapter; mysql 
database: HoneyDo 
username: bd.app 
password: usr.password 
socket: /tmp/mysqXsock 


You Cim safely delete the rest. 

For liie purpose of ill is tutoria l, we are using tlie .same 
database for both devclopmenl and production. This wiO allow 
us to run our application in either del>ug or production mode, 
withoiJl building a .secrond database. Testing, however, needs its 
own database, since its <::ontents will be destroyed when running 
the test suite. 

Now creaie a file containing the test sqL 

drop table if exists iteuis; 
create table items( 

id int not null auta„incrnment, 
title varnhar(tOO) not null* 
de s c ri pt i on t ext not nul 1, 

primary key (id) 

)* 
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We can create tliis table by executing the following 
command: 



/usr/iocal/mysql/bin/mysql HoneyDo u root -p < test,sql 
/usr/local/mysql/bin/mysql HoneyDo^test -u root -p ^ 
test.sql 



Now generate tlie model and controller for this table. 

raby script/generate model Item 
ruby script/generate controller Item 


Ok, let's add one line of actual code, and weYe ready to go. 
bdit apj>/conrrollers/item_controller.rb by adding the line 
scaffold :iicm as sliown below. 

class TtemController < ApplicationController 
scaffold litem 
end 


Now make sure everything is working OK. Well run the 
tests automatically created tiy the generated script. We'll use rake 
to perform the tests. 

rake 


By default, rake will run both the functional and unit 
tests. You should see a uSimilar result line for each test. 

1 tests, I assertionst 0 failures^ 0 errors 

If you get any errors, something is wrong. Go over the 
in.struaions again and make sure you did not miss anything. 

Testing is lx:yond die scope of diis article. In an ideal world, 
you would cTeate a thorough set of tests as you develop the 
application. Many developers write the tests liefore the txxle, 
u.sing it as dieir .specifk'ation for liic actual aide. Testing early 
and often will save you a lot of heartache later. Trust me. 

ff everything looks good, let’s take this puppy out for a test 
drive. Open a new lerniinal window, and from die HoneyDo 
directory launch Raifs built-in server. You could am the server 
in the background, but it produces a lot of output. Additionally, 
anything you piinl fn>m die application (e.g, using print or puts) 
will appear here. 1 often find it useftil to watch the output while 
debugging. So i keep it running in its own window. 

ruby script/server 

Now, point your browser to the following url 
http://kx'alho.st:3000. You should see the "Congratulations, 
you’ve pul Ruby on Rails!’' page. That means the server’s 
working. Now try http://localhosi:3000/item. Alia! Now you’re 
seeing your default item list (curremly empty). Click on the New' 
item link, and it brings up an automatically genemted form. Go 
ahead, add a few items to your database. Play around with the 
interface: look at the list, show specific items, edit them, and 
delete tliem. All the basic functions are already at your fingertips. 

All this comes from the magic of scaffold. This comimnd 
cause.s Rails to check the iteiris table in the database, and 
dynamically creates pages based t>n its columns. Scaffold may 
not produce the most atiraaive pages. We will rewrite most of 
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the dehiult scaffold pages as we develop our application. But it 
does allow us to quickly nuke something hinaional 'ITiis is a 
key insiglu into Rails development, we c|uiekly prcxluce a basic 
application, then iteratively add improvemenus. 

So, if these pages are dynamic, what happens if we add a 
new ct>lumn to our table? Let's try. Log into the database as root: 

/usr/local/niysql/bin/inysql HoneyDo u root p 

Then type the following fK\\ command and exit, 
alter table items add date date after description; 

Now go back to your browser and add a new item. Notice 
the nice, new comlx) boxes for selecting the dale? Some days life 
is easy. 

Building the Basic App 

OK, time to put the toys away and l7uikl a real 
application. First, create a file named fmal.sql containing ihe 
following commands: 

drop table if exists items; 
create table items{ 

Idint not null auto, increment, 
title varchar(lOO) not null, 
descript ion text not null, 
priority inL not null, 
date date not null, 
user_id int not null* 
sender_id int not nul I, 

constraint fk_items_user foreign key (user^id) references 
users(id), 

constraint flc.items^sender foreign key (user^id) references 
users(id)* 

primary key (id) 

): 

drop table if exists users; 
create table users ( 

idint not null autci_increment, 
login varchar(80)default WBLL, 
password varchar (40) default NULL,. 

primary key (id) 

); 

Now load this scliema into boili our deveiopincnl and our 
lest databases: 

mysql 'U root -p HoneyDo < final.sql 
mysql root -p HoneyDo_test < final.sql 

First we need a login system. Fortunately, there's a basic 
login and auilicntication generator available as a ruby gem. 
install the generator: 

sudo gem install lQgin_generator 

Now build the login and aulhenlicaiion system. This creates 
the framework to create new users, and to allow users to log in. 
Note: this only provides a basic login framework. It does not let 
y()u assign different privileges to different users. However, it is 


very easy to expand tliis system to include access control lisLs. 
You can find examples at wwvvMubyonrails.com But for now, 
well stick with the basics. 

ruby script/generate login Security 

Now modify app/controllers/application, rb as follows; 

requi re_dependency ' login_system'' 

class AppllcationCnntroller < ActionControllet;:Base 
Include LogioSystem 
model ;user 

end 

We only want valid users to access our item controOer. So 
modify app/ccjnirol les/ilein_controller.rb 

class ItemController < ApplicationController 
before,fliter iJogin,required 
scaffold ;item 
end 

If someone is not logged in, they should only have access 
to the login and signup actions. Let's lock down everything 
else. In tlie app/controllcrs/sccurily_conLrolkT.rb add the 
following line: 

class SecurityContrcller < ApplicationController 

before^filter :login_required, :except [:login, ;signup] 
layout 'scaffold' 

One more thing, open up the app/mcxleis/userrii file. You 
need to change the salt setting fix>ni tlie default “diaoge-me” 
value. If you are feeling particularly paranoid, you could create 
a randtmi hex-cmly salt value for each user, which could then be 
appended to the pa.sswxird value and saved in ihe tkitabase.— 
But, I leave that as an exercise for the user. 

OK, crank up the rails server and try it out. Going to any of 
the l(x:alho,st:3000/item pages sliould automaiically redirect you 
to the login screen. 'lb create a new user, go to 
lot:alhost:3000/secLirity/signup. Once you sign up, try going to 
the item pages again. 

If you were observant, you probably noticed tliat after 
signing in, you were sent to a pretty worthless welcome page. 
We could edit Lite welcome page. Bui instead, lei\s just send 
everyone directly to the item list. While we re at it, well also set 
the security index page to the list. In 
apf)/conLrollers/seeurity_controller.rb change the empty 
welcome function, and add the following index function. 

def welcome 

redirect_to (;controller “> 'item/* :action ’list*) 
end 

def index 

redireciMo (;controller "> 'item*, laction *) 'list') 
end 

And while we’re rerouting things, let’s take a look at the 
basic routing definitions, 'these are found in config/routes.rb. 
If you open that file, you will see several lines starting with 
inap.connecL... These detennine how URLs are routed through 
your application. It shows that the following URL 
localhost:30{)0/item/shQw/l would be routed to the show 
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miLion of the TleniConiroller, passio^r in a parameter id= l . The 
last two elements are optional. For example, 
localhost:3000/item/list fires ItemController's list action with no 
id. And I oca I host:3000/item fires its index action (which, in our 
case, defaults back to the list action). 

While we*re here, let's make sure that local host:3000 
rec|uests go somew'here useful. Find the line that reads: 

^ map,coimec:t : cant roller => "*welcojae" 

and change it to: 

map.connect iconiraller => ULem\ ;action °> 'list' 

Save and close this file. Now, delete the puhlic/index.htinl 
file. From now^ on pointing your lirowser to local host:3000 will 
send you directly to your ToDo list, or at least ask you to log in. 
One last note nhoui secunty. Once you log in, you wiU 
remain logged in until your session expires. There are two ways 
you can force your session to expire (which can he very useful 
when manually testing). First, close dowm your brow.sen You 
have to actually cjuit the application, not just shut the window. 
Second, navigate to localhust:3000/sccurity/logoui. Well add a 
convenient link to the logout .screen in the next section. 

Iterative Improvements 

So what have we done so far? We can sign-up and 
login to our site. We have a Imsic ToDo list. We can add items 
and delete view and edit the items in our list. But right now, all 
users are viewing copies of the same list. We want to sort our 
ToDo list hy item priority, maybe make it kK)k a IhL nicer. We 
also need to improve the list creation/editing interface. 

First let's add a template for all web pages. For the 
purpose of this article, we’ll make it stupidly simple. And we'll 
use the same template for all pages. 

Create a new^ file named template.rhtml in the 
app/views/layouls folder. Edit the file as follows: 

<!D0CT¥PE lim PUBLIC " //W3C//BTB HTML 4.01 
Tran£itional//EifJ’' 

**http: //wwv,v/3. oi:g/TR/htita4/loose, dtd”) 

<hti 3 il> 

<heiid> 

<%= stylesheet_liEk_tag 'scaffold' %> 

controller.actiDn_]iaffie%></title) 

(/Head) 

(body) 

<%= “(p style=’color; green’>^ [h(§flash[:notice]) I</p>'' il 
@fla£li[:notice] %> 

@content_for_layout %> 

<hr/> 

<div allgn^''center") 

<%^ Time, now %> 

I <16= link_to_uiiless_current 'Add Mew Itejn', ;controller 

'ILem*. ;action =) "new' %> 

I <%= link_to_unless_current 'Show ToDo List', 
icontroller => 

'Item'. :act Lon -> 'list' %> 

I <%= llnk_tD 'logout'. :oont[:oller “) 'Security'* 

: act ion '*> ’ logout'%> 

</div> 


<ybody) 

</html) 

RHTML files are simply lll'ML files that can inckide iiiby 
scripts. These will look quite similar to JSF scripts. Anything 
between “<%” and *'%>'* will iyc executed as a ruby senpL 
and scripts will lie executed and wHI have the results 
placed into the H'FML tlocument. 

Rails also includes, a nytnlx.T of helper functions. kTere 
link_to() and Iinkjo_unless_curre!it{) are helper functions. They 
automatically eremite LfRLs that follow the current routing rules 
for the given actions. Additionally, link_to_ynle,ss_ctirrenf() only 
creates a link when yt>u are not viewing the linked-io page. 

The flash hash is Lcsed to pass messages between objects. 
Here, it looks for any motice objetTs (used by both scaffold and 
security). You can see how die iiiessages are senl by looking at 
the .security mtxlel (app/model/security,rb). 

Play around with the appliraiion a bit. See how you like the 
new IcKik. If you feel adventurous, change the HTML around 
some. Personalize it. 

Now we need to tell Rails to use this template. Add the 
following line to l)Olh app/contrt>llers/item_coniroilerjb and 
app/controliers/security_conlroller.rb 

class ItemController < ApplicationController 
before^fliter ;login_required 
scaffold :ltem 
layout 'template* 

Now wc need to connect tlie item's foreign keys. In each 
item, Ixjth the userjd and the senderjd refer to valid users. In 
l)oth cases, this is a one-to-niay relationship. Each user can have 
any number of ToDo items assigned to him, likewi.se, each user 
can send out any numiier of ToDo items. But each item can only 
have one user and one sender. 

First, we will tell Rails that the items Ixflong to both the 
users and the senders. To do this, modify the item model 
Capp/models/iteni.rb). Add the following lines: 

class Item < ActiveRecord::Base 
belongs_to :user 

belongs_to ^sender* iclass_naiiie ^) 'User', :foreign_key => 
'sender_id' 

The first l>elongs_toO command is the ty|>ical form. 
However, since !)oth foreign keys refer to the same model, we 
need to use a more verlxsse form for the second command. Here 
wc are saying tliat ific modefs sender attribute is actually a User 
objea, using the sender_id key from the database. 

Not surprisingly, we need to Dill the has_inany method in 
the user model (app/models/user.rl)). 

require ‘digest/shal' 

i this iKodel expects a certain database layout and It's based 
□n the naineylogin pattern, 
class User < ActiveRecord::Base 

§ Please change the salt to soinething else, 

^ Every application should use a different one 
§^salt = 'change me' 
cattr_accessor isait 

ha£_jiiany ; todo_it ems, ; class_naiae 'Item'* : forei grukey 
=') 'iiser_id'* 

:order => 'priority UESC* date' 
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has_maiiy : seiiT_iterns, :ciass_iiame => *ltem\ :foreien_key 
“> 'sender_id\ 

: order *=> "date" 

Here both attributes are defined using the verbose form. 
Additionally, I've added the order option, which takes an SQL 
fragment. This will allow Rails to automatically order these items 
for os. 

llie last few changes should have had no visible effea on 
the application. Now it’s time to improve the appearance of the 
ToDo list. First, let’s override the scaffolding method in the item 
controller (app/controllers/item_controller.rb). Add the 
following function to the class definition: 

def list 

“ treqiiest* session [:iiserj 
titeiLlist " @user»todo_items 
@name ©user.login.capitalize 

©pages, ©items ^ paginate(:it6m. :order__by apriority 
DESC, date*, 

:conditlons “> ["user^id * ©user.Id]) 
end 


Tills creates three variables that we will use in the page itselF 
©name is the capitali^^ed version of the user’s login name, ©pages 
will be ased to create the pagination links, and ©items contains an 
array of ToDo items. Tlie i>aginale command will, by dcTaull, t>nly 
allow ten items per page. If we did not want the piigination, we 
could have just used ©usertodo_items, which would automatiailly 
rcLLim a properly-ordered list of all items for the given user 

Now let’s create a helper function for the item's views. 
Open app/helpers/item_helperrb and edit it as follows: 

module ItemHelper 

def priority_name{index) 
ca^e index 

when 0 

“<font color=*greenOlowestC/font)*" 
when 1 

"<10111; color"*greenOLow</font)" 
when 2 

"< font color='yellow’>MedimE</fout 
when 3 

"<font color*^*red'>High</font)" 
when 4 

" < font color" * red '> Ur gent I </ font > “ 
else 

"<font coior='red’ >Undefined</font)>'* 
end 
end 

end 

Finally create two RHTML files in the app/views/item folder: 
Ii.st.rhtml and _rowThtml. 

list.rhtml: 

h(tnamfi) %>'s HoneyDo Listi</hl> 

(table border"* 1* ceiispacing""OpK** ceilpadding"**5px" 
aligii^'*center'*> 

<tjr bgcolor="cc9966'’> 

<th>Ite(iii</th> 

<tb>FriQrity</th> 

<tli>Date</th> 

<th>Sender</th> 

<th>I>esc ript ion</th> 

<ch></tb> 


</tr> 

<%== render :partial => ‘row** :collection => ©items %> 
(^tahle) 

<p><%= ©IteruliSt,length S> Active Items 
'filt:pages; " if ©pages,length > 1 %> 
paginal iorulinks ©pages ?£> 

(%= " &gt;' if ©pages.length > l%></p> 

_row.rhtml: 

<% if (row^countet % 2) " 0 %> 

<tr bgcolor=”#ccffff”> 

<% else %> 

(tr bgccilor"'"jffffr99*> 
end %> 

< td><l4=^h( row. title) %></td> 

<td><%"^r lo rity_name (row. priority) %></ td> 
<td><%'^h{row.date)%></td> 

<td><%"h (row. sender, login) xX/td> 

<td><%=h (t runcate (row. description. 30)) %></td> 

<td> 

<%= link_to['Show\ taction “> "show', :id “> row,id) 
i%=^ link_to( *Edit', : action => *edit' , :id row. id) %> 
link_to( "Delete*. I taction "destroy*, ild -> 

row.id), 

{:confirm “> “Are you sure you want to delete 
lirow.title}"1) %> 

</ td> 

</tr> 

Tiic underscore at the front of _row.rhliiil indicates that it 
is a partial. It cannot l:>e displayed by itself. Rather, it is used 
by the ILst.rhtml file. The rendeK:partial .... :coIlecticm 
method uses the ^row.rhtml file lo render eacli item in the 
©items list. 

Note that before we display any text stored in the database 
we first escape it tising the hO function. Tliis is a standard 
security measure. I wish we lived in a world where we could 
trust our users. Unfortiinarely, weTe not quite there yet. 

The hO helper fiinclion pmvents people frt)m including 
malicitju.s HTML ctxle in llicir ToDo iteriLS. Tlie hO nietliod escapes 
all special IHIVIL characters, replacing gmater th:in imd less than 
c’ltaracleis with ^gt; and ^tll;. If you want to let your users use Mjme 
(reia Lively s^Life) HTML ccxle, you can use Lite saniti2:eO function 
instead. Rtiils also includes, support for a variety of text formatters. 
Tile results of the priority_name{) helper funtiion does not need to 
lx: escuped, since we entered iLs HTML ctxle. 

We should similarly override item's showO method. Besides 
wanting to improve the layout, it will currently display the 
information without escaping it. However, 1 will leave that a.s an 
exerdse for the reader. 

We still need a better inteiface for adding and editing items. 
First add the following four meihcxis to the item's controller 
(app/controllers/item_controller.rii). 

def new 

©itejn - Item.new 

©users = User.finri(:all. ;order ”> 'logic") 
end 

def edit 

©item = Item, find (©parajnsf* id* 1) 

©users “ User.flnd(;all. :order ”> "login") 
end 

def create 

user = ©request .session [: user] 

\iser_id ” ^HrEims["lleju'] .delete("user^id*) 
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The Premier Data Replication Engine for FileMaker^ 

Just Got A Whole Lot Better! 


IDEAL FOR; 

• Continuous Server 
Backup and Recovery 


Dc3te3 Profectlon: 

Protect mission critical data with continuous differential data backup to 
one or more offsite locations. Setup Warm Standby and fail-over servers 
to ensure access to users at any time. 



For more information, including: Special pricing, demo software 
and a FREE technical consultation, contact us NOW ! 


877-548-4920 (toll-free) u.s. 

510-548-4920 international 

VVprldSyfic,com/SD6 


• Warm Standby 

• Server Clustering 

• Multiple Offices 
& Remote Sites 

• Mobile Users 

• Web Server Sync 

• Distributed Versioning 


Mobllll-y: 

Deliver fresh data to users anytime, anywhere in the World. Whether 
your users work on the go, log in from home or work in muitiple locations, 
SyncDeK gives each location its own local copy of the database to access, 
whether users are on or offline. 

Sse>curlty: 

SyncDeK encrypts all data tranmissions and allows you to place 
your actual databases inside of firewalls to prevent intrusion. 


Whc3t £» Ne»w In EsyncDpk &: 

• Continuous Background Sync on servers and laptops - No user interruption 
• Direct integration with FileMaker - No scripting or import/export setup . , r .- i . 

■ SyncDeK Server 6 - Centralized, Secure, Scalable Data Replication ■ ■ ^ 

• FileMaker Server Advanced Replication - No client required 

•Automatic Container field replication , : 

•Version Update Manager for remote FileMaker Servers 














SiteiD " Item.new((iparams[‘item’)) 

fitem. sender “ user 

#itern.user - User-find(user_id) 

&iteiii.date ' Time.new 

If #item.seve 
flsshtrnotice] “ 

"#{#Jtern.title! successfully added to 
#{tfitem.user-.login}'s ToDo list!" 

redirect_to :action ‘list’ 

else 

@users User.find(rail, :order *> ’login*) 

ren(ier_actlQn 'new' 
end 
end 

del save 

user * @request.session[:user] 

ItettLJiash * @paraois f’item'1 
user_id * itemJiash.deieteC'user^id') 

it ten - Item.find(item_hashE*id*J) 

# don’t update the sender! 

Sitem.user " User.find(user_id) 

I don't update the tlinet 


if 0item,update_attributes (itenUiash) 
flash[:notlce] “ "f[#itejn.title} successfully updated!" 
redirect^to iact Ion “> 'list* 
else 

0users “ User.findC;ail, lorder ’login’) 
r ende r_ac tion * edit * 
end 
end 


And create both the new and edit templates 
(app/views/item/new.rhinil and app/views/irem/edit.rhtml 
respectively) 

new.rhtmls 

<X^ error_messages_for(titeia, .'id *> ’ErrorExplanatlon’) X> 
foroLtag raction 'create* X> 

(table cellpaddlng=‘*5px*> 

(tr> 

<td><h>Titla:</h></td> 

Ctd><xnext_field :item, .-title %></td> 

<t r> 

<tr> 

<td><b>Priority:</b></td> 

<td> 

C%-selfict litem, {priority, 

[{'Lowest'* 0]. ['Low', 1]. 

[‘Medium’, 2j * riligh', 3]* 

[’Urgent!’, 4]]%> 

</td> 

(/tr) 

Ctr) 

<td><b>Send To LJser:</b></td> 

<td> 

<%“ collectlon_seleet(:item* :user_ld. 
fusers, rid, :login)%> 

</td> 

</lr> 

</td> 

<td colspan-'l") 

<p><b>Descrlptlan:</b><br/> 

CX"text„area rltem* rdescription. :cois '60', 

;roi.vs “> *20' X></p> 

CX* submit_s;ag "Create ToDo Itein"%> 

(/td> 

</tr) 

</tabl6> 


CX" end_fonii_tag %> 
edit.rfitmli 

<%- error_messages_for( :item, :id ‘ErtorExpianation’) X> 
fonutag : act ion “> ’save' %} 

<%^hidden_fieid ;irem, :id 

(table cellpadding*"5px“> 

(tr> 

(td><b>Iitle{</b>(/cd> 

(td><X"text_field ;item, :title %>(/td) 

(tr> 

(tr> 

(td>(b>Pfiorlty:</b>(/td> 

<td> 

(^“select {itKfl. rpriotity, [['Lowest', Ol,['l,ow*, l], 
[’Medium*. 2j. [*High\ Sj. ['Urgent!', 4]]%> 

(/td)^ 

(/tr> 

<Tr> 

<td>(b>Send To UserK/bX/td^ 

<td> 

(%= coilectlon_select(litem, :user_id, 
fusers, :id, :login 
</td> 

</tr> 

</td> 

<td colspan““2*'> 

<p><b>Desc ription t (/b)(br/) 

<%=text_area {item, {description, :cols ’60’, 

{rows =y ’20' S>C/p) 

(%= subniit_tag "Save ChangeE"%> 

</td> 

</tr> 

(/tabled 

(%" end_forin_tag S> 

Notice, these templates are all quite similar, lliere are a few 
subtle differences, but you could probably move much of die 
ccxie into a common partkil template. Af»ain, HI leave that a,s 
homework. The creatd) and .save() functions also are quite 
similar, but they're small enough and different enough to ignore. 

All right, take a deep breath and l(K>k at what we’ve done. Play 
anjund with tiK" interface. Create multiple users. Notice how easily 
yem can assign IbDo tasks to other users. I'ry editing tasks, and 
changing the aser (thus sending it off to be stjmeone else’s 
msjx)iisihility). Create a lot of tasks for yourself. Notice how die 
pagination autoitiiitically kicks in after you create the eleventh task. 

One more step^ and weVe done. Let’s add validation. 
Open the item modei (app/m<)dles/iLcm.ti>). Edit it as follows; 

class ttera ( Act!veRecord{{Base 
belongs_to {user 

belongs_to :sender, :class_name "> ’User’. :foreign_key “> 
‘sender_id' 

def validate 

unless (O...5).include?(priority) 

errors,add({priority, ’Is Invalid. Must be from 0 to 
4 *) 

end 

end 

validates_fonnat_of {title, :with ”> /\S/, 

{message => ’Title cannot be blank!* 
validates_presence_of rdate, {message *> 'Date missing!’ 
vaHdates_presence_of {user, {message 'User missing!’ 
validatos_presence^of rsender, {message -> ‘Sender 
missing!’ 

f Description is optiorial-iiot validated 
end 
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FifNt, we have added a custom vaJidateO function* This 
function simply checks the priority and makes sure it is greater 
than or equal to 0 and less than 5. ITien we use several Iniill-in 
validation funciions, validatcsJormaLofO tests the title against a 
regular expression. Here, we're simply making sure the title has 
at least one non-whitespace character Next, 
valtdates_presence_oft) makes sure lx>th the dale and user 
aitribules have non-nil values, (see figure 1.) 

I haven't talked about testing in a while. Unfonunately, 
there's a reason for this. When we generated the login 
system, the generator created a decent suite of tests for us. 
However, as weVe moved to the TO release of Rails, some 
things have changed. One important change is to the testing 
system. There have been several performance-related 
improvements, which can (unfortunately) break older 
testing suites, like those automatically created by the 
generator 

F(jr simplicity's sake, Tm going to use die cild-style testing, 
lb do this, we need to add the following lines to the fieginning 
of all test case classes (or modify test/tesi_helper.rbj. 

seif.u5e_transactioiiai_flxtur0s “ false 
self,use„instantiated_fi5rtures “ true 


As of writing this, most of the documentation at 
www.rubyonmils.org still describes the older style tests. Mike 
Clark has a thorough description of these changes on his blog at 
hllp://vvww*darkwarecom/cgi/blo$xom/2005/10/ 



Figure 1. 


Again, writing tests b beyond dte scxtpe of this article. I have, 
however, produced a set of reasonably tliorough tests for thb 
project. Tliese can lx; found In the source code in die following 
.seven files: test/tesLlielper. rt>, test/Lmic/irenOest.rb, 

test/LI nit/user_iest* rb, test/fu nctiona l/item_co n in >1 ler_te^t. rb^ 

test/functional/sa;urily_a)niroller_test.ib, test/fixtures/items-yml, 
and test/fixaiies/users.yml (wlicw!). The tests are organized into two 
test suites* Unit tests are used for checking die models. Functional 
tests are for checking the amiroller and (to a lesser extent) die view. 

Note: The item controller tests do some checks on the 
HTML, If you make changes to the output format, you may 
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Ideas For The Future 


need Ld change these tests. For simplidly, they are all 
grouped into the asserlJitiiiLcheckO function in 
test/test_helper.rh. You can run all the tests by simply typing 
rake. The following two commands will let you run the unit 
tests and the functional tests separately: rake test^units, rake 
lest_functional- 

Problems with Rails 

Don’t get me wrong. I really enjoy working with Rails. 
However, ail ts not sunlight and roses. One of the bigge.st 
problems is that Rails is still an emerging technology. Wjjile 
on the one hand it’s under active development, it is also a 
moving target. More importantly^ you may have to search for 
a host who supporrs Rails <[lK>ygh www.rubyonrails.org has 
an ever-growing list). Rails is only about t8 months old. If it 
manages to Live up to even half its current Uurz, this prc^blem 
will go away. 

The second problem is more surprising. Kails stores session 
infonnation eitlier in files (by default) or in a database table. 
While Rails automates away so many fidtlling issues in web 
development, it dtx^sn't do anything alx>ut this session data. If 
left unchecked, Uiesc files (or tables) will grow until tliey crash 
yt>ur server. This Ls a NkI ihing. 

'Hits problem can easily l>e solved, but it requires you to 
schedule chron joljs on the hosting computer. This is 
probably not a problem on any host who actively supports 
Rails, but it seems like something the framework should 
manage. 


HostedSfore / 

HostedStore provides a TURNKEY 
SOLUTION FOR CREATING A WEB STORE, 

yet Is extensible so developers can use 
the application as a base for creating 
customized solutions for their clients. 

The extensibility of HostedStore provides a 
structure which allows developers to 
create modules that add new functionality 
or altar the built-in features. 






We are seeking software resellers, hosting 
providers, developers, and designers that 
currently offer or plan to offer ecommerce 
solutions to their clients. Resellers receive 
a discount off of the published list price of 
our software and are free to bundle our 
software with their own products and/or 
services. 


www.hostadstore.com 
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WeVe got a funcLional web applotion, buT ihere'^ 
definitely rtK>m h)r jtn]>rc>venient, and one riirhcr dangerous bug 
still lurking around. 

Let's start with the l)ug. WeVe still using scaffolding wlicn 
you display a single item, ritst, we should be able lu imjjrove 
the ap|X*anmce of these pages. More im]xjrtanily, scaffolding 
does not escape the text Ix-Torc displaying it. If a user entered 
dangerous html code in die item's description, scaffolding will 
innocently display it, possibly wiili disastrous a\sults. 

Bottom line, scaffolding is useful for rapid development, bin 
rd remove it belbnc taking any system live. 

Tliere’s a .second, leaser hxig. Right now, any valid user can 
view any item (even items that lx.^long to other users), as long 
as they know (or can guess) die item's id. You can try this at 
home Iry directing your browser to the following URL : 

http://1acalhosl:30()0/item/show/Yr^_ro_r/e«.» 

Again, if we implement the showt) action, we should verify 
tliat the logged-in user and the item's user rruitch. 

Ok, enough of that. What cot>l features rdn we add? 

One obvious ititprovement is adding permissions. A simple 
division w'oiild 1^ to split users into “administrators’' and “users", 
where administrators eotild access, edit, and delete other user 
accoiims. While we'a" at it, there's currently nt^ way for users to 
change ilieir password. 

Second, airnmily wlien you ca^ate a new item, you can send 
that item to any valid user (and all the users are dlspHyed in a 
.single, ungainly list), 'tills is fine wticn ymi liave a lialf-dozen users, 
Ihk just won't work if you have thousands. One solution is to c'neaie 
an invitLM)nly .system, wljem each user can invite (Xher users, and 
only invited users atn .sent! them IbDo items. For a more business- 
oriented application, you criuld organize the users into a hierarchy, 
where only your iimnediate supervisor am send you ToDo items. 
Rails' AciiveRecx)[d atn easily handle all these. Trees are a little 
more complex than tlie simple lias-one or li;is-many relationships, 
Ixit Rails takes most of the pain out of it. Wc don't liave any 
way to view tlie items a user has sent out. That would be nice. 
Items themselves couki Ik‘ improved. We a>uld add due dates. Wc 
could add a status and eo!n]>leted Hags. We could grriup them into 
categories. All of this could ]ic implemented easily witli the 
techniques already presented in tliis article. 

What atxjut autt>matically sending email messages to tlie 
users? Many sites send an e-mail message tliai you must respond 
to when you first sign up. We could do stauething like that. Ruby 
also supports 1 x)L1i reading and genemting RSS feeds. We could 
display new ToDo items to a user's persrjnalized RSS feed 
(though that would let anyone who could gues.s the UiiL read 
their ToDo items). 

Last, but not least, there's Ajax, I'm sure you've lieard about 
Ajax.It has gotten even more buzz than Rails. In a nutshell, Ajax 
uses fancy javascript tricks to produce web pages that respmd 
more ttuickly to user actions. 'Ihis means web pages act more 
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like- ir^iditional desktop applications. A ToDo list has prime 
opportunities for Ajax goodness. However, as anyone who 
works with clietU-side web technologies knows, it’s only gcKxi if 
the browser supports it. Tliis can make writing and testing raw 
Ajax functions a real pain. 

Fortunately, Rails comes complete with a lull set of Ajax 
helper functions. ‘Ihese functi()ns create tested Ajax code tliat 
plays nice w'lth all the Rails components. With these, 
implementing an Ajax interface is almost as easy as 
implementing a mundane, HTMl. interfac'e. 

Resources 

First rd recommend checking out the Ruby on liails website 
(http://ww\v.nibyonraikorg). Its your one-slop pcmal into a 
wealth of information aixmt IxHh Ruby and Rails. However, rd 
also like to highlight the following resfnirces: 

Books: 

• Agile Web Development with Rails 

• Programming Ruby: 'I'he Pragmatic Programmei:s’ Guide. 
Second hdition 

• Ruby In A Nutshell 

Learning Ruby 

• Why*s (Poignant) Guide u> Ruby: httD://poignantQuide.iiet/rufay/ 

• Programming Ruby: 1he PragmaLic Prtvgrammers’ Guide, 
Second Edition: http://wwwjubycentr3lxoni/bQok/ 


Other Rails Tutorials; 

• Rolling with Ruby on Rails: (part 1) 

httD ://www.Dnlamp.CQm/Dub/a/onl3mp/2Q05/01/2Q/rail5.htnil . (part 2) 
httD://www.onlamp.com/oub/a/Qnlamo/2Q05/03/03/rBils.html 

• Ajax t>n Itails: http://www.Qnlamp.eom/Dub/a/onlamp/2005/06/09/ 
rails ajax.html 

Podcasts: 

• Ruby on Rails Podcasi: http://podcast.rubyonrails.orQ/pQdcast.xml 

Feeds 

• Riding Rails: feed://weblog.rubyonr3ils.com/xml/atom10/feed.xnnl 

• Ruby Code mid Style: feed://www.artima.com/rubvG/feeds/rubycsjss 

Others: 

• Rails Mailing List (heavy traffic): Subscribe at 
hTtD://lists.rub v Qnrail5.org/mailman/l[stjnfo/rails 

• IRC: ^^^njbyonrails channel on irc:.freenfKie.net 
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Inkjet and Laser 
Toner Cartridges 
That Create 
Professional 
Looking 
Documents. 


Get OEM printer ink, 
and toner cartridge 
quality at a fraction 
of the cost HI 


We offer high quality 100% compatible 
inkfet cartridges for Epson, Canon, 
Brother, and Xerox printers. Black inkjet 
cartridges from S 3 . 99 , color cartridges 
from $5.99. We also offer Genuine OEM 
HP, Canon, Lexmark, Sharp, and Xerox 
printer ink cartridges and laser toner 
cartridges at discount prices. 
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Plantronics CS50 
and CS50-USB 

What is it? 

If you are a Skype user, or a heavy phone user looking for 
a gtxjd lieadset, then youVe likely liearel of Plantronics. We 
look ai a look at the Plantronics CS50 and it’s cousin, the 0550“ 
USB. Both are wireless ofTice headset systems that gives users 
the al)ility to rtram up to 200^300 feet. Botli use digital 900MHz: 
technology and a noiseHunceling microphone to deliver clear 
and digitally encrypted secure calls (between the headset and 
the base station). Oi50 comes with a customizable head.set, 
weighing 26 grams that can be worn over the ear or over the 
head. An optional behind-the^head mcxlel is also availal^le. The 
headset alst) contains an online .status indicator light. CS50 is 
powered by a Lithium Ion lA)lynier haltery that offers eight hours 
of talk time, gets fitlly recharged in less than 3 hours and 80% 
recharged in 1.5 hours, and its standby time is up to 70 hours. 
The Iraitery Ls compatible with most office or PBX-based 
telephones. CS50 is equipped with an integrated InielliStand 
base unit that features the capability to automaiicaily answer or 
end a call and it includes power, online, and cliarging status 
indicator lights. optional Plantronics IILIO Lifter allows 
taking or ending c^lls remotely, C$50 also features one-u>uch 
volume ctmirol, mute button, and call answer/end functions, 

Tlte Plantronics CS50dJ,SB is specifically designed for 
sofiphones, and other VoIP applications. The cradle is a l)il 
slimmer than the CS50, making it easy to travel wiili if you need 
VoIP in your hotel rcK:)m. 
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Plantronics C550-USB 


What we thought? 

WeVe been using the CS50 and CS50-USB in real life use for 
several month.s. It's lightweight headset can be worn all day, 
and the baUery life is substantial. Clarity is good, and it's nice 
lo have a headset that puts the microphone close to your moulli 
mther than have the volume loss witli a shorter lxx.)m. 

If you need a headset for your phone or s<)rtphone, you 
should definitely consider these prcKJucLs. 


List price: 299.95 

Available from: htt p://www.plaiitronics.com/ 


* b}f MacTeeb Staff 

All 


FAST DVD COPY 4 

PC users have a variety of ways to work witii store bought 
DVD materials. While some are Lising pieces of software like 
tills for nefarious reasons, otliers may want to simply Iraekup up 
tlieir DVDs, or make a copy to for travel or kids. 

If you do need to copy DVDs, and other types of digital 
content, FAST DVD COPY ^ is a digital technology copy 
software for Mac platform that can be used U> copy DVD 
Video collections, Audio CD colieciions, PlayStation 2 
games, DVD-KOMs or CD-ROMs, without losing qualiLy from 
the original. This software also allows copying of almost all 
DVD Videos to blank DVD-R(W) discs, PlayStation 2 games 
U> a DVD“R(W) disc, almost all Audio CDs to a CD-R(W) 
disc, a CD-ROM to a CD^RiW) disc, and a DVD-ROM to a 
nVD-R(W) disc. 




Fast 
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Convert your PowerBook or iBook to a desktop system in 
seconds without misplacing cables or damaging connectors 



New Higher Resolution 
G4 is”- 17” PowerBook 
Docking Station 


m 


• Eliminates cable confusion and damage to connectors. 

• New release levers for easier docking and undocking. 

• Adds only 3” to rear when docked. 

• Also available for G3 PowerBooks. 


iBookEndz 
Docking Station 



12 ” G4 PowerBook New Higher Resolution Docking Station 



Aluminum look to match your PowerBook. 

Eliminates cable confusion and damage to connectors. 
All connectors are routed to the rear of the Dock. 

The Dock converts RGB to standard VGA connector. 
Streamlined design complements your PowerBook. 

Use internal or external speakers. 

Easy to use ejection system. 


Check our Web Site for latest product announcements 


^ BookEndz - Manufactured by OlympicControls Corp. 
1250 Crispin Drive, Elgin, Illinois 60123 
Phone; 888-622-1199 • Fax; 847-742-5686 • www.bookendzdocks.coni 



www.bookendzdocks.com 


















Kool Tools 


it features one-click copy interface^ leverages Macintosh 
dual pnK'essors for faster pRx:essing, removes CSS encryption 
and Maaovision protection, and guarantees privacy with no 
digital mark written on the copied discs. Free update patches for 
FAST DVD COPY 4 are availal^le online. 

FAS'!’ DVD COPY 4 comes with a number of DVD specific 
features such as copying an entire dual-layer DVD video to one 
single-layer DVD-R(W> disc, New Rip Only and Rip & Compress 
modes, suppon for ARccOS-protecied DVDs, RCE protection 
handling, duplication (|Uiility viewer, option to send copy logs to 
tecluiic^l suppon, fully copying multi-channel audio (Dolby 
Digital 5.1, DTS, ITIX), Apple iDVD compatibility, and freedom 
to choose all items or specific items to copy including menus, 
trailers, audio streams, subtitles, lx)nus material, and special 
features. Other DVD specific funaionalities of FAST DVD COPY 
4 include, movie only feature, to copy only the main feature 
without menus or l-xinuses, enabling playliack of copied DVD 
videos on any recent DVD player, support for NTSC and PAL 
formaLs, support for Widescreen and Full Screen sizes, and 
region free DVD eupies. 

'Ihe mitiimum retjuiremenis for installing FAS'f DVD COPY 
4 are any Mac running OS X, 17 GR free disk space, Apple 
SuperDrive or any DVD Imrner compatible with Mac OS X, 
blatik discs (DVD-R(W) or CD-R(W)), and Internet crinneaion 
for activation of the softw^are. 

Tlieir accivaiion method is a bit of a pain, but you can 
get dirough it. Not all DVDs will copy and play, but most 
will. Other than that, the software pretty much docs as you 
would expect. 

FAST DVD COPY 4 cast.s $99.95 for a single a>mputer specific 
license, and Ls available from <http://\vww.festdvdcopyccim/ >. 

- h}f MacTecb ^taff 
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Brenthaven Fusion 
MB Messenger Bag 


First, there was nidio. Then came the golden age of 
television, and after that? Color! So it was with the 
beginnings of home entertainment, so it is with the newest 
additions to the Urenihaven line of cases designed 
specifically for Apple portables. 

The Fusion MB is a messenger style shoulder bag that 
lakes on the usual high quality materials and design 
Brenthaven is known for. As you can see in the image above, 


the color comes on the flap, and extends over die back panel 
of the bag. Ifs constructed of heavy duty ballistic nylon, and 
Ihgh quality zippers, 'fhere are two pouches on die outside, 
both just big enough for plane tickets or a magazine. 'ITie flap 
is held with two clips (no Velcro, which would have been a 
nice addition). New to Brenthaven bags is a hidden water 
bottle liolder. A small zipper on the side conceals the pouch 
that will hold a pretty wide bottle, a very nice new feature. 
The external features are completed with ifie padded 
shoulder strap, and handle. 



On the inside, youVe got a nice assortment of ptx:kcts for 
pens, PDAs, pliones, and all the other little stuff. I’his grouping 
sits righi under the bag llap, making it very accessible. Further 
within are mo mesh pouches, and open space for files. A 
removable laptop sleeve is also included, and provides 
additional padding and shock protection for a computer Inside. 
The owner of Brenilutven routinely takes his bags, and drops 
them, with comptiiers inside, to demonstrate Utat the internal 
sleeve really does work. If you're tough on the equipment, the 
proteaive sleeve alone is more than worth the price. 

Technically, tliis case is classified as a messenger bag. It is 
the heavie.st messenger you 11 come across, owing to the 
materials used in ifs constniciion. Being as this is a messenger 
bag, though, it tentls to have less open space inside dian otlier 
skmlder cases. However, this bag is expanciable. Zip the zipper 
that opens it up, and you've increased the capacity 20%. 

My biggest ct>mplaint alx)ut Brenthaven bags has always 
lieen the single available color. Now, though, navy and silver 
colors are available, along with iJte always classic black. 

The Fusion MB is designed for any Apple portable up to 
15”, and is available from the Apple Store for $99.95. Other 
prtxJuas in die color line up include a color version of the 
Metro, and the Edge I and If 


- fjy Michael R Hartfeyf 
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Are you routinely looking for answers? 


iiiagiiie s year of aiiswers 



MacTech is already read every month 
by tens of thousands of readers. 
Readers that represent the very heart 
and soul of the Mac community. Join 
the crowd and sign up today! 


store.mactech.com 



Missing an issue? 

Coming soon the MacTech CD Voi 1-22, 
containing every issue of MacTech ever printed! 
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NEC Multisync 
20WMGX2 

To [>egin, flat screen monitors are really the only way to go 
anymore. 'Ilieir cost has come down to tlie point where they 
compete favorably with CR'l' displays. ITiey are energy efficient 
like no CRT could ever dream at)out l^eing, and they (usl tend to 
provide a lx:tter looking display. What's not to like? 

The next issue becomes which brand to buy? Well, one very 
gocxl choice would l>e the 20WMGX^ from NEC. Tliis wide 
aspect ratio LCD monitor is packed with feanires. Tlie front 
controls are about what you'd expect on any monitor They feel 
a little mushy, and the button's a bit too sensitive. It includes 
integrated speakers along the bottom of the screen, with volume 
and headset jack on the right side. Interestingly, liie pow'er and 
audio signal lines are accessible, and can be unplugged from tlie 
back t)f the case, so you can attach your own set of speakers if 
you so desire. The 20WMGX^ includes a three port powered 
USB 2.0 hub, two of the ports accessible on the left of the case, 
the third tn the liack with the other conneciicjns. Tack on the 
usual assortment of DVl and VGA connecltoas, and the back of 
the case is almost complete. 'Ihe kicker comes next. 

This display ts also quite a bit more than just a monitor 
Among the many connectors on the Ixick of it is a coax in port 
for hooking up television. Also, S-video and ctrmponent video 
conneaors. The 20WMGX^ has the ability to do picture in 


picture. One screen is your desktop, the other is the TV signal 
coming in. This is an incredibly g<x>cl set up for someone who 
needs to monitor, say, CNBC as well as work, but doesn't have 
the cubicle or desk space Ibr a separate television. Plus, it's just 
cool. Oh yeah, and it comes with a remote conlrol. 

Tlie image quality is wliat really sets the 20WMGX^ ajiart. It is 
briglit. Really briglit. So bright, you-gotta-wear-shades brigltt. In low 
liglit settings, it may be ux> bright, tn Mgh lighting environments, 
though, it's perfect With NEC's OptiClear teclinology^ and crisp 
image quality, the screen reiilly sliines througli in overly lit aieas, or 
with lots of fluorescent ligliting overhead. In dark comers, you can 
aim down the brightness some. 

The only tiling 1 didn't like aix>ul Tlie 20WMGX^ was that 
it is not height adjustable. It's not a killer, but there are otlicr 
manufactures out tliere who build height adjustment into the 
stands, and it would have lx:en nice to see that feature here as 
well. The 20WMGX^ however can be attached to a VESA 
compatible mounting arm, so all Ls not lost. 

Only tile 20WMGX^ has the picture in picture c^apabiiity, 
and it runs for alxjur $799 MSRP. ^Flierc are two oilier models in 
the Multisync GX^ .scries, though. A 17" C70GX^) and 19''( 
90GX^), each wiili a normal aspect ratio screen, most of the 
same features, and the same quality as itie 20WMGX^. Ihe 19" 
runs $499 MSRP, and the 70GX^ $399. Tliese prices are highly 
competitive, and tlie superior cjuality makes any of these three 
LCD screens excellent choices. 

- Michael /?. Harveys 




Ikible Stmlie$\ 


Looking for a great selection of cables? 

MacTech has selected a quality vendor, with quality 
products for your coble needs. Benefits include: 

• Lifetime warranty on cables 

• Same day shipping if you order by 4 PM ET 

• Express shipping orders can be ordered up to 
6:30 PM ET for some day shipping 

• Huge selection - 3500<f items and growing 

Check out the full selection at the MacTech Cable Store 


http://www.mactech.coni/cables 
















PHONEPiPE VOIP Service 



Residential Plans 


The PhonePipe 500 


$14,99 


500 Minutes - US and Canada 


^Additional Minutes 3.5 cents 


The PhonePipe 900 
$19.99 

900 Minutes Canada, Austria^ Belgium, 

Chile, China, Denmark, France, Germany, Hong 
Kong, Ireland. Italy, Malaysia, Netherlands, New 
Zealand, Norway, Singapore, South Korea, Spain, 
Sweden, Switzerland, Taiwan, UK 

^Additional Minutes 3.5 cents 


The PhonePipe 
Unlimited 

$24,99 

Unlimited Minutes 
US and Canada 


The PhonePipe 
Unlimited International 
$34.99 

Unlimited Minutes •‘US, Canada, Austria, 
Belgium, Chile, China, Denmark, France, Germany^ 
Hong Kong, Ireland, Italy, Malaysia, Netherlands, 
New Zealand, Norway, Singapore, South Korea, 
Spain, SwedeiYi Switzerland, Taiwan, UK 


*AII Plans Include Caller ID, Voicemail, and Three-Way Calling 


Base Line 

Starting at 

$20.00 a Month 

Includes: 

• VM oCallerlD 
•3-Way Calling 
•Cali Forwarding 
•Call Waiting Pius 

*Long Distance Starting at 
2 Cents Per Minute 


Business Plans 


Enhanced Line 

Startingat 

$30.00 a Line 

includes: 

• Basic line Features 

* Microsoft Outlook Integration 
•Find Me-Foilow Me 
•Simultaneous Ring 

• Personal Web Portal 

•Long Distance Starting at 
2 Cents Per Minute 


Unlimited Line 
$49.99 a Line 

Includes: 

• Enhanced Line Features 

• Unlimited Long Distance 

to US and Canada 


•Long Distance Starting at 
2 Cents Per Minute 


•All Business Lines Include PBX Features: Call Transfer, Musk on Hold (Customizable), Call Hold, 4 or 5 Digit Dialing 

Optional Features: Auto Attendant, Call Center, Reception Console 


www.PhonePipe.com 
1-877-300-3035 Ext 8200 
























_ other WoM CompuUttg 

inf lir Serving the Mac Universe since ^ 988 

www.MacSales.com • 800.275.4576 


Storage Solutions 






'^SOOGBI 

Summer 

SizzlersL 


Highly Reliable, High-Performance, Plug & Play - 
FireWire fie U $62 External Storage Solutions from $95.99 


NEW! The 
FIRST 

Single drive 
soluticnsf 

MacAldlci 


TTTT* 


solutions from ^ 

Y E R S Pholoihop Lfaar 

♦ ♦♦♦♦ 


Mercury EHle-AL Pro Soiutions 


Mercury Elite-AL Pro FireWire 400+11582 
80GB to 750GB from S119.W, 320GB $189.99 
Mercury Elite-AL Pro FireWire 800/400 
80GB to 750GB from $139.99, 400GB $299.99 
Mercury Elite-AL Pro FireWire 800/400+USB2 
80GB to 750GB from $119.99. 320GB $319.99 


Mercury Elite‘At Pro RAID Solutions 


Mercury Elite-AL Pro 800 
Performance RAID 

160GB to 1.5TB from $219.99, 640GB $359.99 
Mercury Elite-AL Pro 800 
Mirrored RAID Backup 

250GB to 7S0GB from $399,99, S006B $799.99 
Mercury Elite-AL Pro 800 0+1 
Performance+Backup 

500GB to LSTBfrom $679.99, 1.0TB $1599.99 
^Badtupby] 

EMd 

tfospgcfl 


Soluii^ns include ill cabin, EMC Reiinspect Sackupi Htch 
HO Spcedtncih and are pfebrmjtted with free 
software loaded all ready to plug and play your PowerMac. 
PowerBook, IMac, iBook, or eMac too. 


Add Up to 15 7erai>yfes - J5000B - for your Data, 
CraphkSf Audio/Visual, Musk, and Storage 
Needs with a top rated Mercu/y ™ Neptune^ 
or NewerTech^"* Storage 5o/of/on from OWC. 

* Latest Oxford Chipsets 

* Top Hitachi and Seagate Drives 

* EMC Retrospect Backup Certified 

JTli :r 


iWIN flllllf- 

(www.MacSales.co m^ 


^ 2 Year Warranty ^ 

1 Mercury Elite Pro 

Xiassk^ 1 

8068 to SOOGB 


from $97.95 | 

KkAiItTiytiEC 1 

OOGOO ' 




Mac4ddlct 


/>>miniStack"V 2 

FireWire+U5B2 Solutions with 
integrated FireWire and USB2 
Hubs bring high performance 
storage and port convenience 
with capacities 80GB to 750GB 
from $129,00 \ ^ 

.(tjfti 500GB y 

■ solution only 

— 5209.00 


f 


Neptune FireWire 




Hinwll 


5/4EF Pricing on all 
500GB solutions 
MacSales.com/sizzler 


30GB to 500GB solutions 
from $95.99 

HacwBilj 

WI5 

Value Done RIghtI 

See the full line of OWC FireWire soluttons^ as well 
as solutions by LaCity EZ Quest, SmartOlsky and 
Wiebetech online at AfocSafes.com/F/relV/re 


SOOGB ■ # 
► soltiticm only 
^ $265.00 




FirmTek 


/WercaryOn-t/ie-Go 


OWC Mercury On-the-Go Portable The FIRST 

40GB to 160GB from $109.99 ,-.i Po'^t-Siied 

^ Solution up 

aSXSk MacwMlil '* ,*toieoGBi 




[~^| www.MacSales.com/firewire 





Mac Improvement 

Laptop Batteries 

neijje!r*t:^i::tinDlcigi|i 

Batteries that Run Longer and Last Longer! Built in the USA and built 
right for up to 56% more runtime vs. your original Apple stock battery! 
PowerSoo k 64 Ti from $119.99 
PowerBook G4 AL 12/15/17" from $119.99 
iBook G3/64 from $99,95 ^ 

Call or Visit macsales.com/NewerTech 


Laptop Screen Protectors 

Protect your screen! There's an OWC Laptop 
Screen Protector (LSP) product for your Mac. 

PowerBook G4 17" S17,99 PowerBook G4 15" $17.VS 
PowerBook G31 S'* $ 14.99; i Boo k/Po werBook G412** $ 13.9S 
Tl» OWC tips ^re prfOihjrf rat, gffjw soft lei [her protKton tUi\ pimm pMentially 
penrunent maits whicfi un ociur finHn the tridtpad and fcrytxuf cf while your laptao isrbsed. 



The Latest Enhancements 


Aviator Laptop Stand byKeynamics 


E Around Town or Around the World 
ires Flat - 9 oz. only $19.99 


Rain Design 1360'^ 

ATumtaHetcfryoiinjMacGS l?'and 20" 

Village Tronic VTBook 

Add another CRT or Flat Panel Di>(t)lay to yoor Poworbook SZ46.! 

ILugger iMac cases 

for the IMflc G5 or for Wac mini and/or up !□ iO" tCD Display 
5 color cgmMrtations itartinq at S95i.9S 

Network Adapters 

^r^etPresto 10/100/1000 Gtgabtt Ethernet PCI $45.99 

PRAM Batteries 

Is your Mac forgetting what time It OWC PRAM batteries starting at 

Wireless Mouse 

Logitech Cordless Xlkk' Optical Mouse for USB f*i S,94 


SoffibEElcai/ 


Cjomnutin 
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www.macsales.com 




































Not sure what upgrade is 
best for your computer? 
Visit: 




SuperDrive Your Mac 
From Only $44.99! 

Make Music, Movies & More! Add a Fast 
SuperDrive to your Mac to Burn CDs, 
DVDs, even 8.5GB Dual Layer DVDs. 


Trade In ^ 
- Rebates! 




macsales.com/MyOWC 

A cy«ti>stT shofiiilnf exp^rkncr 
ID makm youf Mic m beRitr Mxc, 


aSfo Mitworlil 

W Nil 


Speed it up as high as G4/2.0GHz or 
Dual 1.8GHz! OWC PNN^r 

owe Stocks the fufI line of G3 &G4 Processor- jiinrutr 

upgrades by these leading manufacturers: />> n B uj e r'tecrtifiolo Qt|i 

G4 Single Upgrades from $159,00; G4/1.6GHz only $229,00 
G4 Dual/1.6GHz from $399,99; Dual 1,8GHz from $595,00 

G4 Upgrades for PowerMac G3s. PowerMac G4s, Cube G4, PowerBook G3s - 
Even Legacy PowerMac 7200*9600 Models! 

fSBShL 




0OCOO 


upgrade Your Memory & Save 

Memory forneaflyfVIHYMpctn jroriy< offaOO 275-^576orim/r 
WWW. MacSGk^.com/M^vrK>ry and oi/r mtine Guide 

For NEW 2006 MacBook Pro 15.4" 8t 17", 

(Mac Intel, & Mac mini Intel models 
1GB Kits $99, 2GB Kits to Max for $225 


Money-Back 

on NewerTech 


For PowerMac G5 arrd 
iMac G5 Models: 


itndOWCbfjnd 
upgrsdH' 

Hard Drives 

Sulk up your computur tiy^Jvfng It hl^tier 
capacity ID perform fat your i^eedt. 

Hard Drive Controllers 

Hard Disk Controller Cards 

owe SATA PCI Card $ 47.95 J|pl 


Give US a call or check 
out our website^ Our 
compatibility guide will 
show just what options 
are right tO make your 
Power Mac, PowerBook, 
iMac. etc ■ a Faster Mac 
today! Call SOO.275.4576 
Visit macsales.com/faster 


Internal Hard Drives 
for rMacs, eMacs 3^ PowcrMacs 
S.S- Plug 8, Play40G8 to SOOGfi from ^47.99^ 
2S0GB Supef Value $99.95 

For PowerBooks, iBooks & Mac mtnis 

2.5' 40GB to 160GB from $69.99 

100GB 7200PPM NoleBook PerformantG $1tt9.99 


PC5300 0DR2 667MHX 200 Pin 
512MB Modules only $49.99 
1.0Ge Modules orvly $112.99 
2.068 Match Set only $219.99 
For all PowerBook G4 Models; 
iBook G3/G4S Models: 

256MB Modules from $26.99 
512MB Modules frofn $39.99 
1GB n024MB} Modules from $189.99 
All OWC Memory includes Lifetime 
ADVANCE REPLACEMENT Warranty. 

Software 

Apple OS X Ttger' $119.00 

fail Ktoif box venioD 
OS XI 0.2.10.3 from $17.99 


1 


S12MB Module from $45.99 
1.0GB Module from $87.99 

1, OG 8 Miched Pa i r from $89.99 
2.0GB MaKhed Pair from $175.00 

2. OG B Modu le fro m 5209.99 
4.0GB Matched Pair from $415.00 

For ad PowerMac G4, eMac G4, 
and iMac G4: 

256MB from $24.99 
512MB from $45.99 
IGB from $87.99 


cardT chanrrel PCI SATA$59.99 
Serial ATA 4 Channel PO-M $79.95 

PNH-I 


SATA Enclosures 


owe Mercury Elite-AL PfO FWaOO/400 + USB 2.0/1.1 
bndosure Kit $109.00 

0W 

te mpo ATA & SATA Mac PQ Conlrollefi OWC Mercury £iite SATA RAID Solutions 
Te mpo Trio TireWi re/USBZMTA 131 Perfect for Mass Storage or RAi D. Cables 

all In one PCI $149,00 ^ included, 1 Year OWC Warranty. Starting From $79.9S 

FlrmTek FirmTek 

4-Channel SATA ControllerDual-Bay Hoi Swap External Serial ATA Endosure 
from $ 119.9S with SATA PG Control Fer Card $257.95 

p^lfUV'T 

Mounting System Fuilon 4-Bay SATA Kit $$49.06 

Sonnet GS jivre. add 3 SATA HEH to 
PowerMac GS $95.00 


Not sure what your Mac takes? 

Buy wilh Confidence, till or uieour online gulden. __ 

maesa I es xo m/hard d rives 


^^^^tFacto 


iPod Replacement Batteries 

/>> ne uj e r* tectinal o gys 




Apple ILife‘06 
Make the most out of 
your digital life. Share 
the magk of your 
WFWi < everyday with 
^ iUfe'OaOnly 
iLife 06 -^ $79,00 


highly r«Cflmm«ndi!d 


iPod Replacement Battery Kits 

Easy to Install, Tools Included + Online Installation 
Videos. Get up to 73% more capacity & 20-h Hours Runtime! 

NuPoWBt- 

iPod Batteries for nearly every Apple iPod ____ 
Starting From $14.99 ««»«« 

Not comfortabie opening your iPod? 

For $39 + the cost of the battery. OWC installs it for you - iPod 
shipping Box and FedEx Overnight covered to and from! 
macsales.coTn/iPodinstall 

OWC's full line af iPod Batteries, Accessories, and 
more online at macsaiesxomftPod 


Pay le$s. Get more. Surf faster! 


Mac-Only e r 
Internet 


per monthl 


High-Speed Nationwide 
Dial-up and DSL Services 
Toll-Free Tech Support & 
More from Mac Experts 

VisitFasterMac.net or call 
toll free 800-869-9152 to 
learn more or to sign up. 


f ikv^. waiUkilti ^ are tiib^ ta rbanft iittdiwt notin. Itiejni rtiHriH4 vitkin 34 mM<t be uibjett lo i mteckiB^ ft*. 

4* rttitm idU leatceptH itHhHt RttHtn McrikHidbe Aiith«rttatkHi mraber. 


Di.^W(ivl4C>nRetld^ 
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□Work Longer? DWork Harder? 


How to Stop 

Racing the Clock 




^ Energize Your Mac! 


We know your day keeps getting longer and longer. With every release of software, your Mac is 
bogged down even more. With every click, there's a pause. You find yourself working longer, working harder. 
A faster Mac means that you can work faster, not harder ~ be more productive! 


Let the original Mac Performance Shop help. Daystar has been creating Mac speed for over 16 years. 
Whether your bottleneck is storage, connectivity or just raw CPU speed, we deliver the performance you 
need, where you need it. 



3j600 


m': 


CPU Upgrades for Raw Speed. We upgrade any Power Macintosh, 
any IMac Flat Panel, any PowerBook G3 and some PowerBook G4s. 

Fast and Large Storage for Real-Time Video. OurTURBOS4r/t 

solutions can make your drives perform like RAM. Projects open in a 
flash and edit in real-time. 

Extreme Wireless. Wireless is great, unless you're getting slow 
transfers. Even Airport Extreme's are slow when the signal is weak, 
Daystar can boost your signals and energize your wireless network. 

But, if You Really need a G5? Daystar Is the only Mac Performance 
Manufacturer that Is also an Apple Authorized Reseller. Not only can 
you trade-in your system for the latest and greatest... but the Daystar 
Pro's can upgrade It for maximum performance! 

Call 877-439-8646 and beat the clock. 

^ Authorized Reseller 


' SMMBavstar 

■ '> A aV'a r - - -- 




Daystar Technology - Your Macintosh Performance Shop 

5018 Bristol Industrial Way, #202, Buford, GA 30518 USA 
Toll Free: 877-439-8646 or 770-614-5400 


Oaystar-Tech.com 


Daystar-Forum.com 


Daystar-Store.com 
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